MCP Tools Reference: gmailmcp.googleapis.com

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

Добавляет метки ко всей ветке обсуждений в учетной записи Gmail авторизованного пользователя. Эта операция затрагивает все сообщения, находящиеся в данный момент в ветке, а также любые будущие сообщения, добавленные к ней.

Если вы не уверены в идентификаторе темы, сначала воспользуйтесь инструментом search_threads .

Если вы не уверены в идентификаторе метки пользователя, сначала воспользуйтесь инструментом list_labels , чтобы узнать доступные метки и их идентификаторы. Чтобы добавить метку «корзина» или «спам» к ветке обсуждения, используйте вместо этого инструмент apply_sensitive_thread_label .

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

Запрос 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": "label_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запрос сообщения для RPC-вызова LabelThread.

LabelThreadRequest

JSON-представление 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Поля
threadId

string

Обязательно. Уникальный идентификатор темы, к которой нужно добавить метки.

labelIds[]

string

Обязательно. Уникальные идентификаторы добавляемых меток. Может быть системным идентификатором метки (например, «Входящие», «Помечено звездочкой», «Непрочитано», «Важно») или пользовательским идентификатором метки. Инструмент принимает label_ids , а не имена меток. Используйте инструмент list_labels, чтобы получить соответствующий идентификатор метки и отобразить имя для пользовательских меток.

Схема вывода

Ответное сообщение для RPC-вызова LabelThread.

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

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

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

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

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