Read a message

email_get_message · Reads only · Markdown

One message in full: its text, HTML and attachment names.

Free*

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

Read me the email Paul Hoffmann sent about his repair.

Your agent callsemail_get_messageFree*

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

{
  "message_id": "6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04"
}

What comes back

{
  "message": {
    "message_id": "6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04",
    "inbox": "support@halverson-cycle-repair.useconecto.com",
    "direction": "in",
    "from": "paul.hoffmann@example.com",
    "from_name": "Paul Hoffmann",
    "to": [
      "support@halverson-cycle-repair.useconecto.com"
    ],
    "cc": [],
    "subject": "My Tabor's repair",
    "at": "2026-10-14T08:00:00+00:00",
    "thread": "<CAF7d2k1x@mail.example.com>",
    "thread_state": "open",
    "thread_labels": [],
    "contact_id": 4101,
    "spam": "PASS",
    "ticket": 1,
    "text": "Hello, my Tabor was due back from its repair yesterday. Can you tell me when I can pick it up?\n\nPaul\n",
    "html": "",
    "attachments": []
  }
}

Use it when

A message in a list needs reading before an answer.

What it does

One message in full: text, HTML and attachment names. Free.

What comes back

The message in full: its headers, text, HTML, attachments, thread, contact and ticket. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`message_id`Required	string	Exactly 36 characters.

The call

Over MCP, call email_get_message on https://api.conecto.chat/mcp/email. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/email_get_message \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message_id":"6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04"}'

When it refuses

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

Code	When	What to do
`not_found`404	No message of the business has that message_id.	Find the message with email_list_messages and use its message_id.

More Email tools

All 10 tools

Give this to your agent.

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

Read a message

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Email tools

Give this to your agent.