MCP Tools Reference: gmailmcp.googleapis.com

Strumento: label_thread

Aggiunge etichette a un'intera conversazione nell'account Gmail dell'utente autenticato. Questa operazione interessa tutti i messaggi attualmente presenti nella conversazione e tutti i messaggi futuri aggiunti.

Se non sei sicuro dell'ID della conversazione, utilizza prima lo strumento search_threads.

Se non sei sicuro dell'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.

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

Schema di input

Messaggio di richiesta per l'RPC LabelThread.

LabelThreadRequest

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

string

Obbligatorio. L'identificatore univoco della conversazione a cui aggiungere le etichette.
labelIds[]

string

Obbligatorio. Gli identificatori univoci delle etichette da aggiungere. Può essere un ID di etichetta di sistema (ad es. "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD") o un ID di etichetta definita dall'utente.

Schema di output

Messaggio di risposta per l'RPC LabelThread.

Annotazioni dello strumento

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