MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: label_message

Agrega una o más etiquetas a un mensaje específico en la cuenta de Gmail del usuario autenticado.

Para encontrar el ID del mensaje, usa herramientas como search_threads o get_thread. Si no estás seguro del ID de una etiqueta de usuario, usa primero la herramienta list_labels para descubrir las etiquetas disponibles y sus IDs. Para agregar una etiqueta de papelera o de spam a un mensaje, usa la herramienta apply_sensitive_message_label.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta MCP label_message.

Solicitud de 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
}'

Esquema de entrada

Mensaje de solicitud para LabelMessage RPC.

LabelMessageRequest

Representación JSON 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
Campos
messageId

string

Obligatorio. Es el ID del mensaje al que se agregarán las etiquetas.
labelIds[]

string

Obligatorio. Son los IDs de las etiquetas que se agregarán. Puede ser un ID de etiqueta del sistema (p.ej., "INBOX", "STARRED", "UNREAD", "IMPORTANT") o un ID de etiqueta definido por el usuario. La herramienta acepta label_ids y no nombres de etiquetas. Usa la herramienta list_labels para obtener el ID de etiqueta correspondiente a un nombre visible para las etiquetas definidas por el usuario.

Esquema de salida

Mensaje de respuesta para LabelMessage RPC.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ❌

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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