Read a message
read_messageRetrieve the full body of an email by ID, including any verification code and attachment metadata. Optionally save attachments and HTML to disk.
Instructions
Read the full body of a message by id, including any verification code detected in it. Lists attachment metadata; pass save_dir to also save the attachments and the HTML body to disk (where the provider supports downloads).
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": {
"id": "<id>"
},
"name": "read_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Message id (from list_messages) | |
| address | No | Inbox address; defaults to the most recent inbox | |
| save_dir | No | Directory to save attachments and body.html/body.txt into, written to <save_dir>/<message-id>/ (e.g. "/tmp") |