MCP Tools Reference: gmailmcp.googleapis.com

Strumento: get_thread

Recupera una specifica thread di email dall'account Gmail dell'utente autenticato, incluso un elenco dei relativi messaggi.

Il parametro facoltativo messageFormat controlla il formato dei messaggi restituiti. Per impostazione predefinita (o con FULL_CONTENT), restituisce l'intero contenuto dei messaggi. Utilizza MINIMAL per includere solo l'oggetto e lo snippet (escluso il corpo). Utilizza METADATA_ONLY per includere solo i metadati di base (ID messaggio, ID thread, etichette, timestamp e stima delle dimensioni).

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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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: il formato MINIMAL restituisce id, snippet, oggetto, da, a, cc, data, labelIds. Il formato METADATA_ONLY restituisce id, da, a, cc, data, labelIds. FULL_CONTENT restituisce id, snippet, oggetto, da, a, cc, data, labelIds, attachmentIds, plaintextBody, htmlBody, allegati.

MessageFormat

Enumerazione 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.
METADATA_ONLY Solo metadati: non include oggetto, snippet, corpo, nomi dei file allegati.

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,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    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

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

string

Solo output. Gli ID allegato, compilati solo se MessageFormat era FULL_CONTENT.
htmlBody

string

Il contenuto HTML dell'email, compilato solo se MessageFormat era FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Solo output. Gli allegati, compilati solo se MessageFormat era FULL_CONTENT.
labelIds[]

string

Gli ID delle etichette allegate al messaggio. Include gli ID delle etichette utente e delle etichette di sistema standard limitate a INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT.

AttachmentMetadata

Rappresentazione JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Campi
id

string

Solo output. L'ID dell'allegato.
mimeType

string

Il tipo MIME dell'allegato.
filename

string

Il nome del file dell'allegato.

Annotazioni dello strumento

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata