MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: label_thread

Agrega etiquetas a un subproceso completo en la cuenta de Gmail del usuario autenticado. Esta operación afecta a todos los mensajes que se encuentran actualmente en el hilo y a los mensajes futuros que se agreguen a él.

Si no conoces el ID del subproceso, primero usa la herramienta search_threads.

Si no conoces el ID de una etiqueta del usuario, primero usa la herramienta list_labels para descubrir las etiquetas disponibles y sus IDs.

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

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

Esquema de entrada

Es el mensaje de solicitud para la RPC de LabelThread.

LabelThreadRequest

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

string

Obligatorio. Es el identificador único del subproceso al que se agregarán etiquetas.
labelIds[]

string

Obligatorio. Son los identificadores únicos de las etiquetas que se agregarán. Puede ser un ID de etiqueta del sistema (p.ej., "INBOX", "TRASH", "SPAM", "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

Es el mensaje de respuesta para la RPC de LabelThread.

Anotaciones de herramientas

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