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/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

Схема ввода

Запрос сообщения для 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,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Поля
labelId

string

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

name

string

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

color

object ( LabelColor )

Необязательно. Цвет этикетки.

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

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

threadsTotal

integer

Общее количество нитей под этим названием.

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

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

threadsUnread

integer

Количество непрочитанных сообщений под этим тегом.

Цвет этикетки

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

string

Цвет текста метки, представленный в виде шестнадцатеричной строки (например, "#000000"). Допускаются только следующие предопределенные наборы цветовых значений: #000000 , #434343 , #666666 , #999999 , #cccccc , #efefef , #f3f3f3 , #ffffff , #fb4c2f , #ffad47 , #fad165 , #16a766 , #43d692 , #4a86e8, #4a86e8 #a479e2 , #f691b3 , #f6c5be , #ffe6c7 , #fef1d1 , #b9e4d0 , #c6f3de , #c9daf8 , #e4d7f5 , #fcdee8 , #efa093 , #ffd6a2 , #fce8b3 , #89d3b2 . #a0eac9 , #a4c2f4 , #d0bcf1 , #fbc8d9 , #e66550 , #ffbc6b , #fcda83 , #44b984 , #68dfa9 , #6d9eeb , #b694e8 , #f7a7c0 , #cc3a21 , #eaa041 , #f2c960 , #149e60 , #3dc789 , #3c78d8 , #8e63ce , #e07798 , #ac2b16 , #cf8933 , #d5ae49 , #0b804b , #2a9c68 , #285bac , #653e9b , #b65775 , #822111 , #a46a21 , #aa8831 , #076239 , #1a764d , #1c4587 , #41236d , # #83334c , #464646 , #e7e7e7 , #0d3472 , #b6cff5 , #0d3b44 , #98d7e4 , #3d188e , #e3d7ff , #711a36 , #fbd3e0 , #8a1c0a , # #f2b2a8 , # #7a2e0b , #ffc8af , #7a4706 , #ffdeb5 , #594c05 , #fbe983 , #684e07 , #fdedc1 , #0b4f30 , #b3efd3 , #04502e , #a2dcc1 , #c2c2c2 , #4986e7 , #2da2bb , #b99aff , #994a64 , #f691b2 , #ff7537 , #ffad46 , #662e37 , #ebdbde , #cca6ac , #094228 , #42d692 , #16a765

backgroundColor

string

Цвет фона метки, представленный в виде шестнадцатеричной строки (например, "#ffffff"). Допускаются только следующие предопределенные наборы цветовых значений: #000000 , #434343 , #666666 , #999999 , #cccccc , #efefef , #f3f3f3 , #ffffff , #fb4c2f , #ffad47 , #fad165 , #16a766 , #43d692 , #4a86e8, #4a86e8 #a479e2 , #f691b3 , #f6c5be , #ffe6c7 , #fef1d1 , #b9e4d0 , #c6f3de , #c9daf8 , #e4d7f5 , #fcdee8 , #efa093 , #ffd6a2 , #fce8b3 , #89d3b2 . #a0eac9 , #a4c2f4 , #d0bcf1 , #fbc8d9 , #e66550 , #ffbc6b , #fcda83 , # #44b984 , #68dfa9 , #6d9eeb , #b694e8 , #f7a7c0 , #cc3a21 , #eaa041 , #f2c960 , #149e60 , #3dc789 , #3c78d8 , #8e63ce , #e07798 , #ac2b16 , #cf8933 , #d5ae49 , #0b804b , #2a9c68 , #285bac , #653e9b , #b65775 , #822111 , #a46a21 , #aa8831 , #076239 , #1a764d , #1c4587 , #41236d , # #83334c , #464646 , #e7e7e7 , #0d3472 , #b6cff5 , #0d3b44 , #98d7e4 , #3d188e , #e3d7ff , #711a36 , #fbd3e0 , #8a1c0a , # #f2b2a8 , # #7a2e0b , #ffc8af , #7a4706 , #ffdeb5 , #594c05 , #fbe983 , #684e07 , #fdedc1 , #0b4f30 , #b3efd3 , #04502e , #a2dcc1 , #c2c2c2 , #4986e7 , #2da2bb , #b99aff , #994a64 , #f691b2 , #ff7537 , #ffad46 , #662e37 , #ebdbde , #cca6ac , #094228 , #42d692 , #16a765

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

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

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.labels
  • https://www.googleapis.com/auth/gmail.metadata