conecto. Get started
Google Workspace

Search Google Drive

google_drive_search · Reads only · Markdown

Files in a mailbox user's Drive, shared drives included, whose words match.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Find the returns policy Doc in our Drive.

Your agent callsgoogle_drive_searchFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "mailbox": "support@halversoncycle.example",
  "query": "returns policy"
}
What comes back
{
  "mailbox": "support@halversoncycle.example",
  "files": [
    {
      "id": "1Kq3xYvA8bFzN2wL6pTq9RmJc0dUe4HsV",
      "name": "Returns policy",
      "size": null,
      "folder": false,
      "type": "application/vnd.google-apps.document",
      "modified_at": "2026-10-14T08:00:00+00:00",
      "link": "https://docs.google.com/document/d/1Kq3xYvA8bFzN2wL6pTq9RmJc0dUe4HsV/edit"
    }
  ]
}

Use it when

The agent needs a document the team keeps in Drive.

What it does

Files in a mailbox user's Drive (shared drives included) whose words match: name, size, kind, when changed and its link. Free.

What comes back

mailbox; files: each with id, name, size, folder, type, modified_at and link. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
mailboxstringOne of the mailboxes the agent may act as; optional when only one is connected. Up to 254 characters.
queryRequiredstring1 to 200 characters.
limitinteger1 to 50. Default: 20.

The call

Over MCP, call google_drive_search on https://api.conecto.chat/mcp/googleworkspace. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/google_drive_search \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@halversoncycle.example","query":"returns policy"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_connected409Google Workspace isn't connected yet.Connect it with google_connect.
not_allowed403The mailbox is not one the agent may act as.Use a connected mailbox; the owner adds one by connecting again.
vendor_rejected502Google refused: delegation is missing a scope, or Google said no.Ask the Workspace admin to grant what the message names.

More Google Workspace tools

All 11 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md