conecto. Get started
Google Workspace

Read a Gmail message

google_mail_read · Reads only · Markdown

One message in full, with its body as text and its attachments' names.

Free*

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

An example

Open Rachel's Gmail message about the Tabor and read all of it.

Your agent callsgoogle_mail_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",
  "message_id": "192e1f0a7c3b9d41"
}
What comes back
{
  "mailbox": "support@halversoncycle.example",
  "message": {
    "id": "192e1f0a7c3b9d41",
    "subject": "Where is my Tabor?",
    "from": "rachel.kim@example.com",
    "from_name": "Rachel Kim",
    "to": [
      "support@halversoncycle.example"
    ],
    "received_at": "Wed, 14 Oct 2026 07:41:09 +0000",
    "read": false,
    "thread_id": "192e1f0a7c3b9d41",
    "cc": [],
    "body": "Hi,\n\nI ordered the Tabor three weeks ago. When does it ship?\n\nRachel",
    "attachment_list": [
      {
        "name": "invoice-INV-0042.pdf",
        "type": "application/pdf",
        "size": 48211
      }
    ]
  }
}

Use it when

A search found the message and the agent needs all of it before answering.

What it does

One message in full: sender, recipients, the body as text and its attachments' names. Free.

What comes back

mailbox; message: id, subject, from, to, cc, received_at, body, thread_id, and attachment_list when there are any. 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.
message_idRequiredstring1 to 200 characters.

The call

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

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

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.

More Google Workspace tools

All 11 tools

Give this to your agent.

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