gws-mcp__gmail_read_thread
Reads a whole Gmail conversation by its thread ID, the threadId that gmail_search, gmail_list and gmail_read return. Answers every message of the thread in one call, in the order they were sent, oldest to newest, drafts and messages in Trash included and marked as such. With depth full, the default, each message carries its from, to, cc, subject and date, the decoded text body, and its attachments with the part IDs gmail_get_attachment takes. With depth headers, each message carries the same headers and Gmail's snippet but no body, which keeps a long conversation small. The bodies of one answer are held to 200,000 characters together: when a thread is longer, the bodies of its oldest messages are left out, and left_out lists those message IDs, each readable in full by gmail_read.
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": {
"thread_id": "<thread_id>"
},
"name": "gws-mcp__gmail_read_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | full (the default): headers, decoded text body and attachments for each message. headers: headers and Gmail's snippet only, no body or attachments. | |
| account | No | Optional email address of the connected account to use (e.g. 'user@gmail.com'). If omitted, the default account is used. | |
| thread_id | Yes | The Gmail thread ID, as threadId in a gmail_search, gmail_list or gmail_read answer | |
| max_body_chars | No | Cuts each message's body to this many characters, with a truncation marker, before the 200,000 character total is applied. Applies to depth full. |