MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: label_thread

Adiciona marcadores a uma conversa inteira na conta do Gmail do usuário autenticado. Essa operação afeta todas as mensagens na conversa e as que forem adicionadas a ela no futuro.

Se você não tiver certeza do ID da linha de execução, use a ferramenta search_threads primeiro.

Se você não tiver certeza do ID de um rótulo do usuário, use primeiro a ferramenta list_labels para descobrir os rótulos disponíveis e os IDs deles.

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

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

Mensagem de solicitação para a RPC LabelThread.

LabelThreadRequest

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

string

Obrigatório. O identificador exclusivo da conversa a que os marcadores serão adicionados.

labelIds[]

string

Obrigatório. Os identificadores exclusivos dos rótulos a serem adicionados. Pode ser um ID de rótulo do sistema (por exemplo, "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT") ou um ID de rótulo 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 LabelThread.

Anotações de ferramentas

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