conecto. Get started
Email

Read a thread

email_get_thread · Reads only · Markdown

Every message of one conversation, oldest first.

Free*

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

An example

Show me the whole back-and-forth with Ladd's Bakery about servicing their cargo bikes.

Your agent callsemail_get_threadFree*

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
{
  "thread": [
    {
      "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": []
    },
    {
      "message_id": "aeef8aef-c643-47d3-872a-f74bb319e996",
      "inbox": "support@halverson-cycle-repair.useconecto.com",
      "direction": "out",
      "from": "support@halverson-cycle-repair.useconecto.com",
      "from_name": "Halverson Support",
      "to": [
        "paul.hoffmann@example.com"
      ],
      "cc": [],
      "subject": "Re: 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": null,
      "ticket": 1,
      "text": "Hello Paul,\n\nsorry for the wait. The new derailleur came this morning, and your Tabor is ready to pick up on Friday.\n\nSam, Halverson Cycle & Repair\n\nThis message was written by Halverson Cycle & Repair's AI assistant.",
      "html": "",
      "attachments": []
    }
  ]
}

Use it when

Before answering an email that is part of a longer exchange.

What it does

Every message in the same conversation, oldest first. Free.

What comes back

thread: every message of the conversation, oldest first, each in full. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
message_idRequiredstringExactly 36 characters.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/email_get_thread \
  -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.

CodeWhenWhat to do
not_found404No 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