MCP Tools Reference: gmailmcp.googleapis.com

Tool: `get_thread`

Retrieves a specific email thread from the authenticated user's Gmail account, including a list of its messages.

The following sample demonstrate how to use curl to invoke the get_thread MCP tool.

Curl Request
curl --location 'https://gmailmcp.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_thread", "arguments": { // provide these details according to the tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

Curl Request

curl  
--location  
 'https://gmailmcp.googleapis.com/mcp' 
  
 \ 
--header  
 'content-type: application/json' 
  
 \ 
--header  
 'accept: application/json, text/event-stream' 
  
 \ 
--data  
 '{ 
 "method": "tools/call", 
 "params": { 
 "name": "get_thread", 
 "arguments": { 
 // provide these details according to the tool MCP specification 
 } 
 }, 
 "jsonrpc": "2.0", 
 "id": 1 
 }'

Input Schema

Request message for GetThread RPC.

GetThreadRequest

JSON representation
{ "threadId" : string , "messageFormat" : enum ( `MessageFormat` ) }

Fields

Fields
`threadId`	`string` Required. The unique identifier of the thread to fetch.
`messageFormat`	`enum ( MessageFormat )` Optional. Specifies the format of the messages returned within the thread. Defaults to FULL_CONTENT.

threadId

string

Required. The unique identifier of the thread to fetch.

messageFormat

enum ( MessageFormat )

Optional. Specifies the format of the messages returned within the thread. Defaults to FULL_CONTENT.

Output Schema

Thread containing a list of messages.

Thread

JSON representation
{ "id" : string , "messages" : [ { object ( `Message` ) } ] }

Fields

Fields
`id`	`string` The unique identifier of the thread.
`messages[]`	`object ( Message )` A list of messages in the thread, ordered chronologically.

id

string

The unique identifier of the thread.

messages[]

object ( Message )

A list of messages in the thread, ordered chronologically.

Message

JSON representation
{ "id" : string , "snippet" : string , "subject" : string , "sender" : string , "toRecipients" : [ string ] , "ccRecipients" : [ string ] , "date" : string , "plaintextBody" : string }

Fields
`id`	`string` The unique identifier of the message.
`snippet`	`string` Snippet of the message body.
`subject`	`string` The message subject extracted from headers:
`sender`	`string` Sender email address.
`toRecipients[]`	`string` To recipient email addresses.
`ccRecipients[]`	`string` CC recipient email addresses.
`date`	`string` Date of the message in ISO 8601 format (YYYY-MM-DD).
`plaintextBody`	`string` Full body content, only populated if MessageFormat was FULL_CONTENT.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌