MCP Tools Reference: gmailmcp.googleapis.com

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

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

Чтобы найти идентификатор сообщения, используйте такие инструменты, как search_threads или get_thread . Если вы не уверены в идентификаторе метки пользователя, сначала воспользуйтесь инструментом list_labels , чтобы узнать доступные метки и их идентификаторы. Чтобы добавить метку «Корзина» или «Спам» к сообщению, используйте вместо этого инструмент apply_sensitive_message_label .

В следующем примере показано, как использовать curl для вызова инструмента label_message 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_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

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

LabelMessageRequest

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

string

Обязательно. Идентификатор сообщения, к которому нужно добавить метки.

labelIds[]

string

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

Схема вывода

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

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

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

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

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

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