conecto. Get started
Google Workspace

Read a Google Drive file

google_drive_read · Reads only · Markdown

A Drive file's words: Docs, Sheets, Slides, text, PDF or Office, up to 5 MB.

Free*

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

An example

What does the returns policy Doc in Drive say about ridden bikes?

Your agent callsgoogle_drive_readFree*

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",
  "file_id": "1Kq3xYvA8bFzN2wL6pTq9RmJc0dUe4HsV"
}
What comes back
{
  "mailbox": "support@halversoncycle.example",
  "file": {
    "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",
    "text": "Returns policy\r\n\r\nBikes can be returned within 30 days, unridden and with every part."
  }
}

Use it when

A search found the document and the agent needs what it says.

What it does

A file's words, up to 5 MB: Google Docs, Sheets (as CSV) and Slides, text, PDF and Office files; files are read in a separate, capped process. Free.

What comes back

mailbox; file: id, name, size, type, modified_at, link and text. 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.
file_idRequiredstring1 to 200 characters.

The call

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

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

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.
not_found404Google Workspace has no such message, event or file.Search first and use its id.
too_large413The file is over 5 MB.Open it at its link.
unsupported_type400The file is not one Conecto reads.Open it at its link.

More Google Workspace tools

All 11 tools

Give this to your agent.

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