read-email
Retrieve a single email by ID and get its content, sender, recipients, and metadata. Enable headers mode to examine security and authentication headers.
Instructions
Read a single email by id (read-only). Default: returns the full message body (HTML stripped to text by default), subject, from/to/cc, receivedDateTime, conversationId, attachments metadata, and webLink as Markdown. With headersMode: true: returns RFC-822 forensic headers instead (DKIM, SPF, DMARC, Received chain, Message-ID, Authentication-Results) — pair with importantOnly: true for the security-relevant subset, groupByType: true for category-bucketed view, or raw: true for JSON instead of Markdown. With includeHeaders: true (non-headers-mode): adds basic headers alongside body. Use outputVerbosity (minimal/standard/full) to control field count.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ID of the email to read | |
| raw | No | Return raw JSON instead of Markdown (headersMode only, default: false) | |
| groupByType | No | Group headers by category (headersMode only, default: false) | |
| headersMode | No | Return forensic headers instead of email content (default: false) | |
| importantOnly | No | Show only important headers (headersMode only, default: false) | |
| includeHeaders | No | Include basic headers alongside email content (default: false) | |
| outputVerbosity | No | Output detail level (default: standard) |