get_messageRead a received email; use get_thread for its conversation.
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | readable (default) gives the newly written reply text when it can be extracted. full gives the original bodies, quoted history, HTML and transport details. | |
| message_id | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Input schema / properties / format / descriptionPrevious value: -"Defaults to extracted reply text when available. Use full for original bodies, quoted history, HTML and transport details."New value: +"readable (default) gives the newly written reply text when it can be extracted. full gives the original bodies, quoted history, HTML and transport details."Output schema / anyOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "attachments": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "content_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "disposition": {
- "type": [
- "string",
- "null"
- ]
- },
- "filename": {
- "type": [
- "string",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "mime_type": {
- "type": "string"
- },
- "related": {
- "type": "boolean"
- },
- "size": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "id",
- "filename",
- "size",
- "mime_type",
- "disposition",
- "content_id",
- "related"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "body": {
- "type": [
- "string",
- "null"
- ]
- },
- "body_source": {
- "anyOf": [
- {
- "enum": [
- "reply_text",
- "text",
- "html"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "reply_text is heuristic extraction, not the original body. Use full format for quoted history, forwards or ambiguous inline answers; complete means untruncated, not original."
- },
- "body_status": {
- "description": "For truncated bodies, use get_message. For not_ready, check again later. For plain_text_unavailable, use full format if html_available.",
- "enum": [
- "not_ready",
- "plain_text_unavailable",
- "truncated",
- "complete"
- ],
- "type": "string"
- },
- "cc": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- },
- "from": {
- "anyOf": [
- {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
- ]
- },
- "html_available": {
- "type": "boolean"
- },
- "id": {
- "type": "string"
- },
- "inbox_id": {
- "type": "string"
- },
- "labels": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "processing_status": {
- "enum": [
- "pending",
- "processing",
- "ready",
- "failed"
- ],
- "type": "string"
- },
- "received_at": {
- "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
- "type": "string"
- },
- "reply": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "in_reply_to": {
- "type": "string"
- },
- "subject": {
- "type": [
- "string",
- "null"
- ]
- },
- "to": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- }
- },
- "required": [
- "in_reply_to",
- "to",
- "subject"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "reply_to": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- },
- "subject": {
- "type": [
- "string",
- "null"
- ]
- },
- "thread_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "to": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- }
- },
- "required": [
- "id",
- "inbox_id",
- "thread_id",
- "received_at",
- "processing_status",
- "labels",
- "from",
- "reply_to",
- "to",
- "cc",
- "subject",
- "body",
- "body_source",
- "body_status",
- "html_available",
- "attachments",
- "reply"
- ],
- "type": "object"
- },
- {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "content": {
- "additionalProperties": false,
- "properties": {
- "attachments": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "content_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "disposition": {
- "type": [
- "string",
- "null"
- ]
- },
- "filename": {
- "type": [
- "string",
- "null"
- ]
- },
- "id": {
- "type": "string"
- },
- "mime_type": {
- "type": "string"
- },
- "related": {
- "type": "boolean"
- },
- "size": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "id",
- "filename",
- "size",
- "mime_type",
- "disposition",
- "content_id",
- "related"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "bcc": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- },
- "cc": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- },
- "date": {
- "description": "Sender-supplied Date header: ISO when parseable, otherwise original header text; not receipt time.",
- "type": [
- "string",
- "null"
- ]
- },
- "from": {
- "anyOf": [
- {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
- ]
- },
- "html": {
- "type": [
- "string",
- "null"
- ]
- },
- "in_reply_to": {
- "type": [
- "string",
- "null"
- ]
- },
- "message_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "references": {
- "type": [
- "string",
- "null"
- ]
- },
- "reply_text": {
- "description": "Heuristically extracted reply; null means unavailable, an empty string means no new text detected. Original text and HTML are preserved.",
- "type": [
- "string",
- "null"
- ]
- },
- "reply_to": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- },
- "sender": {
- "anyOf": [
- {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- {
- "type": "null"
- }
- ]
- },
- "subject": {
- "type": [
- "string",
- "null"
- ]
- },
- "text": {
- "type": [
- "string",
- "null"
- ]
- },
- "to": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "group": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "address": {
- "type": "string"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "address"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "name": {
- "type": "string"
- }
- },
- "required": [
- "name",
- "group"
- ],
- "type": "object"
- }
- ]
- },
- "type": "array"
- }
- },
- "required": [
- "from",
- "sender",
- "reply_to",
- "to",
- "cc",
- "bcc",
- "subject",
- "message_id",
- "in_reply_to",
- "references",
- "reply_text",
- "date",
- "text",
- "html",
- "attachments"
- ],
- "type": "object"
- },
- "envelope_from": {
- "type": "string"
- },
- "envelope_to": {
- "type": "string"
- },
- "id": {
- "type": "string"
- },
- "inbox_id": {
- "type": "string"
- },
- "labels": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "message_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "processing_status": {
- "const": "ready",
- "type": "string"
- },
- "raw_size": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "received_at": {
- "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
- "type": "string"
- },
- "subject": {
- "type": [
- "string",
- "null"
- ]
- },
- "thread_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "inbox_id",
- "thread_id",
- "received_at",
- "processing_status",
- "labels",
- "envelope_from",
- "envelope_to",
- "subject",
- "message_id",
- "raw_size",
- "content"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "envelope_from": {
- "type": "string"
- },
- "envelope_to": {
- "type": "string"
- },
- "id": {
- "type": "string"
- },
- "inbox_id": {
- "type": "string"
- },
- "labels": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "message_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "processing_status": {
- "enum": [
- "pending",
- "processing",
- "failed"
- ],
- "type": "string"
- },
- "raw_size": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "received_at": {
- "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
- "type": "string"
- },
- "subject": {
- "type": [
- "string",
- "null"
- ]
- },
- "thread_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "id",
- "inbox_id",
- "thread_id",
- "received_at",
- "processing_status",
- "labels",
- "envelope_from",
- "envelope_to",
- "subject",
- "message_id",
- "raw_size"
- ],
- "type": "object"
- }
- ]
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "attachments": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "content_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "disposition": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filename": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "mime_type": {
+ "type": "string"
+ },
+ "related": {
+ "type": "boolean"
+ },
+ "size": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "id",
+ "filename",
+ "size",
+ "mime_type",
+ "disposition",
+ "content_id",
+ "related"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "body": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "body_source": {
+ "anyOf": [
+ {
+ "enum": [
+ "reply_text",
+ "text",
+ "html"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "reply_text: only the newly written text, extracted without quoted history; empty when none was found. For forwards, quoted history or answers written inline, read format full. text: the plain-text body. html: text taken from the HTML body."
+ },
+ "body_status": {
+ "description": "complete: body is not truncated. truncated: get_message returns the whole body. not_ready: no parsed content yet; while processing_status is pending or processing, read again shortly; when it is failed, read the original with read_raw_message. plain_text_unavailable: read format full if html_available.",
+ "enum": [
+ "not_ready",
+ "plain_text_unavailable",
+ "truncated",
+ "complete"
+ ],
+ "type": "string"
+ },
+ "cc": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "from": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "html_available": {
+ "type": "boolean"
+ },
+ "id": {
+ "type": "string"
+ },
+ "inbox_id": {
+ "type": "string"
+ },
+ "labels": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "processing_status": {
+ "enum": [
+ "pending",
+ "processing",
+ "ready",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "received_at": {
+ "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
+ "type": "string"
+ },
+ "reply": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "in_reply_to": {
+ "type": "string"
+ },
+ "subject": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "to": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "in_reply_to",
+ "to",
+ "subject"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Suggested in_reply_to, recipients and subject for send_message. to comes from sender-written headers: check it against the assignment."
+ },
+ "reply_to": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "subject": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "thread_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "to": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "inbox_id",
+ "thread_id",
+ "received_at",
+ "processing_status",
+ "labels",
+ "from",
+ "reply_to",
+ "to",
+ "cc",
+ "subject",
+ "body",
+ "body_source",
+ "body_status",
+ "html_available",
+ "attachments",
+ "reply"
+ ],
+ "type": "object"
+ },
+ {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "content": {
+ "additionalProperties": false,
+ "properties": {
+ "attachments": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "content_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "disposition": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filename": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "mime_type": {
+ "type": "string"
+ },
+ "related": {
+ "type": "boolean"
+ },
+ "size": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "id",
+ "filename",
+ "size",
+ "mime_type",
+ "disposition",
+ "content_id",
+ "related"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "bcc": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "cc": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "date": {
+ "description": "Sender-supplied Date header: ISO when parseable, otherwise original header text; not receipt time.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "from": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "html": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "in_reply_to": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "message_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "references": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reply_text": {
+ "description": "Newly written text extracted from the body; empty when none was found, null when extraction was not possible.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reply_to": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "sender": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "subject": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "to": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "address": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "address"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "group"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "from",
+ "sender",
+ "reply_to",
+ "to",
+ "cc",
+ "bcc",
+ "subject",
+ "message_id",
+ "in_reply_to",
+ "references",
+ "reply_text",
+ "date",
+ "text",
+ "html",
+ "attachments"
+ ],
+ "type": "object"
+ },
+ "envelope_from": {
+ "type": "string"
+ },
+ "envelope_to": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "inbox_id": {
+ "type": "string"
+ },
+ "labels": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "processing_status": {
+ "const": "ready",
+ "type": "string"
+ },
+ "raw_size": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "received_at": {
+ "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
+ "type": "string"
+ },
+ "subject": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "thread_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "inbox_id",
+ "thread_id",
+ "received_at",
+ "processing_status",
+ "labels",
+ "envelope_from",
+ "envelope_to",
+ "subject",
+ "message_id",
+ "raw_size",
+ "content"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "envelope_from": {
+ "type": "string"
+ },
+ "envelope_to": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "inbox_id": {
+ "type": "string"
+ },
+ "labels": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "processing_status": {
+ "enum": [
+ "pending",
+ "processing",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "raw_size": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "received_at": {
+ "description": "Absolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.",
+ "type": "string"
+ },
+ "subject": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "thread_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "inbox_id",
+ "thread_id",
+ "received_at",
+ "processing_status",
+ "labels",
+ "envelope_from",
+ "envelope_to",
+ "subject",
+ "message_id",
+ "raw_size"
+ ],
+ "type": "object"
+ }
+ ]
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so the safety profile is fully covered by structured data. The description adds no behavioral detail beyond that — nothing about the readable/full format choice, attachment handling, or permissions — so it is only minimum-viable on this dimension.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight clauses with the main action front-loaded and the routing hint second. No filler, though it is terse enough that it withholds information an agent would find useful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return values need no explanation, and annotations cover the safety profile. For a two-parameter read tool the description is nearly sufficient, missing only a note on the format trade-off and cross-references to raw/attachment readers.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 50%: the format enum is richly documented inside the schema itself, while message_id carries no description. The description contributes zero parameter meaning — it never mentions format, readable-vs-full, or message_id — so it does not compensate for the uncovered half.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb+resource ("Read a received email") and explicitly separates itself from the sibling get_thread. "Received" implicitly distinguishes it from get_sent_message/read_raw_message, though those siblings are never named, so it falls just short of the top tier.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It names the alternative (get_thread) and the condition that selects it ("for its conversation"), which is exactly the routing an agent needs. It gives no when-not-to-use guidance relative to read_raw_message or read_attachment, so it is clear context rather than full exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.