MCP Tools Reference: gmailmcp.googleapis.com

Outil : label_thread

Ajoute des libellés à l'ensemble d'une conversation dans le compte Gmail de l'utilisateur authentifié. Cette opération affecte tous les messages actuellement dans la conversation et tous les messages futurs qui y seront ajoutés.

Si vous n'êtes pas sûr de l'ID de la conversation, utilisez d'abord l'outil search_threads.

Si vous n'êtes pas sûr de l'ID d'un libellé utilisateur, utilisez d'abord l'outil list_labels pour découvrir les libellés disponibles et leurs ID.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP label_thread.

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

Schéma d'entrée

Message de requête pour le RPC LabelThread.

LabelThreadRequest

Représentation JSON
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Champs
threadId

string

Obligatoire. Identifiant unique de la conversation à laquelle ajouter des libellés.

labelIds[]

string

Obligatoire. Identifiants uniques des libellés à ajouter. Peut être un ID de libellé système (par exemple, "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT") ou un ID de libellé défini par l'utilisateur. L'outil accepte les label_ids, et non les noms de libellés. Utilisez l'outil list_labels pour obtenir l'ID de libellé correspondant à un nom à afficher pour les libellés définis par l'utilisateur.

Schéma de sortie

Message de réponse pour le RPC LabelThread.

Annotations d'outil

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ❌ | Indication Open World : ❌