gmail_get_thread
Retrieve up to ten messages from a specific Gmail thread by its exact thread ID. Use this tool to read private email content securely when you need the full conversation in one response.
Instructions
Read up to ten messages from one exact Gmail thread. Private content is returned only on the fresh response and is not replayable.
This private-response read always fetches fresh provider data. Its MCP schema intentionally omits idempotency_key; supplied replay identity is rejected.
Args: thread_id (required): Exact Gmail thread ID. max_messages: Bounded message count from 1 to 10. project_id: Authenticated Project UUID. project_ref: Exact project correlation reference. connector_account_ref: Project-bound connector account alias. effect: Required and must be read; Spring verifies it. approval_ref: Approved platform task UUID when resuming a write.
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": {
"project_id": "<project_id>",
"project_ref": "<project_ref>",
"connector_account_ref": "<connector_account_ref>",
"effect": "<effect>"
},
"name": "gmail_get_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| effect | Yes | ||
| thread_id | No | ||
| project_id | Yes | ||
| project_ref | Yes | ||
| approval_ref | No | ||
| max_messages | No | ||
| connector_account_ref | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |