MCP Tools Reference: gmailmcp.googleapis.com

Outil : label_message

Ajoute un ou plusieurs libellés à un message spécifique dans le compte Gmail de l'utilisateur authentifié.

Pour trouver l'ID du message, utilisez des outils tels que search_threads ou get_thread. 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. Pour ajouter un libellé "Corbeille" ou "Spam" à un message, veuillez plutôt utiliser l'outil apply_sensitive_message_label.

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

Requête 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
}'

Schéma d'entrée

Message de requête pour le RPC LabelMessage.

LabelMessageRequest

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

string

Obligatoire. ID du message auquel ajouter les libellés.
labelIds[]

string

Obligatoire. ID des libellés à ajouter. Il peut s'agir d'un ID de libellé système (par exemple, "INBOX", "STARRED", "UNREAD", "IMPORTANT") ou d'un ID de libellé défini par l'utilisateur. L'outil accepte les label_ids, mais pas 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 LabelMessage.

Annotations d'outils

Indication de destruction : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ❌ | Indication de monde ouvert : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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