MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: unlabel_message

Remove um ou mais marcadores de uma mensagem específica na conta do Gmail do usuário autenticado. Para encontrar o ID da mensagem, use ferramentas como search_threads ou get_thread. Se você não tiver certeza do ID de um marcador de usuário, use a ferramenta list_labels primeiro para descobrir os marcadores disponíveis e os IDs deles.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP unlabel_message.

Solicitação 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

Solicita uma mensagem para UnlabelMessage RPC.

UnlabelMessageRequest

Representação JSON 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
Campos
messageId

string

Obrigatório. O ID da mensagem de que os marcadores serão removidos.
labelIds[]

string

Obrigatório. Os IDs dos marcadores a serem removidos. Pode ser um ID de marcador do sistema (por exemplo, "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT") ou um ID de marcador definido pelo usuário. A ferramenta aceita label_ids e não nomes de marcadores. Use a ferramenta list_labels para receber o ID do marcador correspondente a um nome de exibição para marcadores definidos pelo usuário.

Esquema de saída

Mensagem de resposta para UnlabelMessage RPC.

Anotações da ferramenta

Dica destrutiva: ✅ | Dica idempotente: ✅ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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