MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: list_labels

Lista todos os marcadores definidos pelo usuário disponíveis na conta do Gmail do usuário autenticado. Use essa ferramenta para descobrir o id de um rótulo do usuário antes de chamar label_thread, unlabel_thread, label_message ou unlabel_message. Os marcadores do sistema não são retornados por essa ferramenta, mas podem ser usados com os IDs conhecidos: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".

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

Solicitação curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_labels",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para a RPC ListLabels.

ListLabelsRequest

Representação JSON 
{

  "pageSize": integer

  "pageToken": string
}
Campos

Campo de união _page_size.

_page_size pode ser apenas de um dos tipos a seguir:
pageSize

integer

Opcional. O número máximo de rótulos a serem retornados.

Campo de união _page_token.

_page_token pode ser apenas de um dos tipos a seguir:
pageToken

string

Opcional. Token de página para recuperar uma página específica de resultados na lista.

Esquema de saída

Mensagem de resposta para a RPC ListLabels.

ListLabelsResponse

Representação JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Campos
labels[]

object (Label)

Lista de marcadores do usuário na conta dele.
nextPageToken

string

Token para recuperar a próxima página de resultados na lista.

Rótulo

Representação JSON 
{
  "labelId": string,
  "name": string
}
Campos
labelId

string

O identificador exclusivo do rótulo.
name

string

O nome de exibição legível do rótulo.

Anotações de ferramentas

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