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 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 unlabel_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": "unlabel_message",
    "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 UnlabelMessage.

UnlabelMessageRequest

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

string

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

string

Obligatorio. 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 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 UnlabelMessage.

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