MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: unlabel_message

Quita una o más etiquetas de 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.

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

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

Esquema de entrada

Mensaje de solicitud para UnlabelMessage RPC.

UnlabelMessageRequest

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

string

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

string

Obligatorio. Son los IDs de las etiquetas que se quitarán. Puede ser un ID de etiqueta del sistema (p.ej., "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT") o un ID de etiqueta definida 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 UnlabelMessage RPC.

Anotaciones de herramientas

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