MCP Tools Reference: gmailmcp.googleapis.com

Инструмент: list_labels

Этот инструмент отображает все пользовательские метки, доступные в учетной записи Gmail авторизованного пользователя. Используйте его, чтобы узнать id пользовательской метки перед вызовом label_thread , unlabel_thread , label_message или unlabel_message . Системные метки не возвращаются этим инструментом, но могут использоваться с их общеизвестными идентификаторами: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'.

В следующем примере показано, как использовать curl для вызова инструмента MCP list_labels .

Запрос 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
}'

Схема ввода

Запрос сообщения для RPC ListLabels.

ListLabelsRequest

JSON-представление 
{

  "pageSize": integer

  "pageToken": string
}
Поля

Объединенное поле _page_size .

_page_size может принимать только одно из следующих значений:

pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых меток.

Поле объединения _page_token .

_page_token может принимать только одно из следующих значений:

pageToken

string

Необязательный параметр. Токен страницы для получения конкретной страницы результатов в списке.

Схема вывода

Ответное сообщение для RPC-запроса ListLabels.

ListLabelsResponse

JSON-представление 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Поля
labels[]

object ( Label )

Список пользовательских меток в учетной записи пользователя.

nextPageToken

string

Токен для перехода на следующую страницу результатов в списке.

Этикетка

JSON-представление 
{
  "labelId": string,
  "name": string
}
Поля
labelId

string

Уникальный идентификатор метки.

name

string

Удобочитаемое отображаемое название метки.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌