MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: list_labels

Wyświetla wszystkie etykiety zdefiniowane przez użytkownika dostępne na koncie Gmaila uwierzytelnionego użytkownika. Użyj tego narzędzia, aby poznać id etykiety użytkownika przed wywołaniem label_thread, unlabel_thread, label_message lub unlabel_message. Etykiety systemowe nie są zwracane przez to narzędzie, ale można ich używać z ich znanymi identyfikatorami: „INBOX”, „TRASH”, „SPAM”, „STARRED”, „UNREAD”, „IMPORTANT”, „CHAT”, „DRAFT”, „SENT”.

Poniższy przykład pokazuje, jak użyć curl, aby wywołać narzędzie MCP list_labels.

Żądanie 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
}'

Schemat wejściowy

Komunikat żądania dla RPC ListLabels.

ListLabelsRequest

Zapis JSON 
{

  "pageSize": integer

  "pageToken": string
}
Pola

Pole zbiorcze _page_size.

_page_size może mieć tylko jedną z tych wartości:
pageSize

integer

Opcjonalnie. Maksymalna liczba etykiet do zwrócenia.

Pole zbiorcze _page_token.

_page_token może mieć tylko jedną z tych wartości:
pageToken

string

Opcjonalnie. Token strony, który umożliwia pobranie określonej strony wyników na liście.

Schemat wyjściowy

Komunikat odpowiedzi dla RPC ListLabels.

ListLabelsResponse

Zapis JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Pola
labels[]

object (Label)

Lista etykiet użytkownika na koncie użytkownika.
nextPageToken

string

Token umożliwiający pobranie następnej strony wyników na liście.

Etykieta

Zapis JSON 
{
  "labelId": string,
  "name": string
}
Pola
labelId

string

Unikalny identyfikator etykiety.
name

string

Wyświetlana nazwa etykiety w formie czytelnej dla ludzi.

Adnotacje narzędzia

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca działania idempotentnego: ✅ | Wskazówka dotycząca działania tylko do odczytu: ✅ | Wskazówka dotycząca działania w otwartym świecie: ❌