Get message
Tool ID: email_message_get
Summary
Opens a single message by its IMAP uid (the id returned from search) and returns headers plus the body. Long bodies are truncated to your mailbox’s size limit.
When to use it
- Read the full email — After a search, open the message you care about.
- Prepare a reply — Read the original before asking to reply.
- Quote details — Pull exact wording, dates, or addresses from a message.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Email credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
uid |
Yes | IMAP message id from Search messages (must be a positive number). |
mailbox |
No | Account id. Omit for the default mailbox. |
folder |
No | Folder that contains the message. Default: INBOX. |
What you get back
| Field | Meaning |
|---|---|
mailbox |
Account used |
message |
The message details (subject, from, to, date, body, uid, and related fields) |
The body may be truncated if it exceeds the configured maximum length (often around 20,000 characters).
Example prompts
Open the full text of the inbox message with uid 3182.
Search for emails from Acme about the contract, then open the most recent one and summarize it.
Get message 905 from the Sent folder in the sales mailbox.
Tips
- Uid + folder — The uid is unique within a folder. Always use the same folder you searched.
- Truncation — If the end of a long email is missing, ask your administrator about the body length limit, or focus on the part you need.