MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: label_message

Adiciona um ou mais marcadores a 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 do usuário, use primeiro a ferramenta list_labels para descobrir os marcadores disponíveis e os IDs deles. Para adicionar um marcador de lixeira ou spam a uma mensagem, use a ferramenta apply_sensitive_message_label.

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

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

Esquema de entrada

Mensagem de solicitação para o RPC LabelMessage.

LabelMessageRequest

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

string

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

string

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

Esquema de saída

Mensagem de resposta para o RPC LabelMessage.

Anotações de ferramentas

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