MCP Tools Reference: gmailmcp.googleapis.com

Strumento: label_message

Aggiunge una o più etichette a un messaggio specifico nell'account Gmail dell'utente autenticato.

Per trovare l'ID messaggio, utilizza strumenti come search_threads o get_thread. Se non conosci l'ID di un'etichetta utente, utilizza prima lo strumento list_labels per scoprire le etichette disponibili e i relativi ID. Per aggiungere un'etichetta Cestino o Spam a un messaggio, utilizza lo strumento apply_sensitive_message_label.

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

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

Schema di input

Messaggio di richiesta per RPC LabelMessage.

LabelMessageRequest

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

string

Obbligatorio. L'ID del messaggio a cui aggiungere le etichette.
labelIds[]

string

Obbligatorio. Gli ID delle etichette da aggiungere. Può essere un ID etichetta di sistema (ad es. "INBOX", "STARRED", "UNREAD", "IMPORTANT") o un ID etichetta definito 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 LabelMessage.

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