MCP Tools Reference: gmailmcp.googleapis.com

Strumento: get_thread

Recupera una specifica thread email dall'account Gmail dell'utente autenticato, inclusa una lista dei suoi messaggi.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_thread.

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
}'

Schema di input

Messaggio di richiesta per la RPC GetThread.

GetThreadRequest

Rappresentazione JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Campi
threadId

string

Obbligatorio. L'identificatore univoco del thread da recuperare.
messageFormat

enum (MessageFormat)

Facoltativo. Specifica il formato dei messaggi restituiti all'interno del thread. Il valore predefinito è FULL_CONTENT.

Schema di output

Thread contenente un elenco di messaggi.

Thread

Rappresentazione JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Campi
id

string

L'identificatore univoco del thread.
messages[]

object (Message)

Un elenco di messaggi nel thread, ordinati cronologicamente.

Messaggio

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

string

L'identificatore univoco del messaggio.
snippet

string

Snippet del corpo del messaggio.
subject

string

L'oggetto del messaggio estratto dalle intestazioni:
sender

string

Indirizzo email del mittente.
toRecipients[]

string

Agli indirizzi email dei destinatari.
ccRecipients[]

string

Indirizzi email dei destinatari in Cc.
date

string

Data del messaggio nel formato ISO 8601 (AAAA-MM-GG).
plaintextBody

string

Contenuti del corpo completo, compilati solo se MessageFormat era FULL_CONTENT.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌