graph_read_mail
Retrieve full details of a specific email by message ID, choosing HTML or text body format and optionally using immutable IDs or a shared mailbox.
Instructions
Read full details of a specific email.
Args: message_id: The email message ID. body_type: Body format to request: "html" or "text" (default "html"). Use "text" to avoid pulling large HTML bodies into context. immutable_ids: Whether to ask Graph for immutable message IDs (default false). A message ID changes when the message is moved, so a stored ID stops working; an immutable ID survives the move. mailbox: Shared mailbox address or user ID to act on. Empty targets your own mailbox. Requires the delegated Mail.*.Shared permissions.
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": {
"message_id": "<message_id>"
},
"name": "graph_read_mail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mailbox | No | ||
| body_type | No | html | |
| message_id | Yes | ||
| immutable_ids | No |