read_email
Read a specific email by account, folder, and UID without marking it read; retrieve decoded headers, plain-text body, attachment list, and threading details.
Instructions
Read one message: decoded headers, body and attachment list, without marking it read.
By default only the plain-text body is returned, truncated at 50,000
characters to fit MCP result limits; the untruncated sizes are always
reported as text_full_length and html_full_length. Attachments are
listed with a 1-based part index for save_attachment. Threading
headers (message_id, in_reply_to, references) are included.
Args: account: Account name from list_accounts. folder: Folder containing the message. uid: Message UID from search_messages. include_html: Also return the HTML body (default false). HTML mail can be very large. include_text: Return the plain-text body (default true). body_max_chars: Truncate each body to this many characters (default 50000).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account": "<account>",
"folder": "<folder>",
"uid": "<uid>"
},
"name": "read_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | ||
| folder | Yes | ||
| account | Yes | ||
| include_html | No | ||
| include_text | No | ||
| body_max_chars | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | Yes | ||
| to | Yes | ||
| bcc | Yes | ||
| uid | Yes | ||
| date | Yes | ||
| from | Yes | ||
| html | Yes | ||
| seen | Yes | ||
| text | Yes | ||
| flags | Yes | ||
| folder | Yes | ||
| flagged | Yes | ||
| subject | Yes | ||
| date_iso | Yes | ||
| message_id | Yes | ||
| references | Yes | ||
| attachments | Yes | ||
| in_reply_to | Yes | ||
| html_full_length | Yes | ||
| text_full_length | Yes |