MCP Tools Reference: gmailmcp.googleapis.com

Strumento: label_thread

Aggiunge etichette a un'intera discussione nell'account Gmail dell'utente autenticato. Questa operazione interessa tutti i messaggi attualmente presenti nel thread e tutti i messaggi futuri che verranno aggiunti.

Se non conosci l'ID thread, utilizza prima lo strumento search_threads.

Se non conosci l'ID di un'etichetta utente, utilizza prima lo strumento list_labels per scoprire le etichette disponibili e i relativi ID.

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

Curl Request 
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": "label_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per RPC LabelThread.

LabelThreadRequest

Rappresentazione JSON 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Campi
threadId

string

Obbligatorio. L'identificatore univoco del thread a cui aggiungere le etichette.
labelIds[]

string

Obbligatorio. Gli identificatori univoci delle etichette da aggiungere. Può essere un ID etichetta di sistema (ad es. "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT") o un ID etichetta definita dall'utente. Lo strumento accetta label_ids e non i nomi delle etichette. Utilizza lo strumento list_labels per ottenere l'ID etichetta corrispondente a un nome visualizzato per le etichette definite dall'utente.

Schema di output

Messaggio di risposta per la RPC LabelThread.

Annotazioni dello strumento

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