MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: list_labels

Wyświetla listę wszystkich etykiet zdefiniowanych przez użytkownika, które są dostępne na koncie Gmail 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/v1' \
--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's 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,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Pola
labelId

string

Unikalny identyfikator etykiety.
name

string

Wyświetlana nazwa etykiety w formie czytelnej dla ludzi.
color

object (LabelColor)

Opcjonalnie. Kolor etykiety.

Pole zbiorcze _threads_total.

_threads_total może mieć tylko jedną z tych wartości:
threadsTotal

integer

Łączna liczba wątków z tą etykietą.

Pole zbiorcze _threads_unread.

_threads_unread może mieć tylko jedną z tych wartości:
threadsUnread

integer

Liczba nieprzeczytanych wątków z tą etykietą.

LabelColor

Zapis JSON 
{
  "textColor": string,
  "backgroundColor": string
}
Pola
textColor

string

Kolor tekstu etykiety w postaci ciągu szesnastkowego (np. „#000000”).
backgroundColor

string

Kolor tła etykiety w postaci ciągu szesnastkowego (np. „#ffffff”).

Adnotacje narzędzia

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca idempotentności: ✅ | Wskazówka dotycząca trybu tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌