MCP Tools Reference: gmailmcp.googleapis.com

Strumento: get_thread

Recupera un thread di email specifico dall'account Gmail dell'utente autenticato, inclusa una lista dei messaggi.

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

Richiesta curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--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's 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. Nota: se hai bisogno di contenuti del corpo o allegati, utilizza FULL_CONTENT. Quando utilizzi MINIMAL, i campi plaintext_body e attachment_ids non verranno compilati. Se non sai quale formato utilizzare, affidati al comportamento predefinito utilizzando FULL_CONTENT.

MessageFormat

Enum per controllare il livello di dettaglio dei messaggi nel thread.

Enum
MESSAGE_FORMAT_UNSPECIFIED Il valore predefinito è FULL_CONTENT.
MINIMAL Restituisce snippet di messaggi e intestazioni chiave (Oggetto, Da, A, Cc, Data).
FULL_CONTENT Restituisce tutte le informazioni in "MINIMAL" più il contenuto completo del corpo di ogni messaggio.

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.

Message

Rappresentazione JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    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

Indirizzi email dei destinatari.
ccRecipients[]

string

Indirizzi email dei destinatari in Cc.
date

string

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

string

Contenuto completo del corpo, compilato solo se MessageFormat era FULL_CONTENT.
attachmentIds[]

string

Solo output. Gli ID degli allegati, compilati solo se MessageFormat era FULL_CONTENT.

Annotazioni dello strumento

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