MCP Tools Reference: gmailmcp.googleapis.com

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

Извлекает конкретное электронное письмо из учетной записи Gmail авторизованного пользователя по его уникальному идентификатору.

Используйте этот инструмент для проверки отдельного электронного письма, если вам уже известен его идентификатор. Если пользователь хочет подробно прочитать конкретное письмо, проверить точную формулировку сообщения или изучить метаданные вложений к одному письму, это подходящий инструмент. Он не подходит для получения целых переписок или просмотра веток обсуждений; вместо этого используйте инструмент «get_thread». Ключевые индикаторы включают в себя запрос пользователя на получение полного содержимого сообщения с определенным идентификатором, полученного в результате предыдущего поиска, или запрос на проверку конкретного электронного письма, а не всей ветки обсуждения. Примеры запросов пользователей: «Получить полный текст сообщения с идентификатором 18f123456789abcd», «Прочитать последнее сообщение в этой ветке от Алисы» и «Какие имена вложений в письме, которое я только что получил от отдела кадров?»

Необязательный параметр messageFormat управляет форматом возвращаемого сообщения. По умолчанию (или с FULL_CONTENT ) он возвращает полное содержимое сообщения. Используйте MINIMAL , чтобы включить только тему и фрагмент (исключая тело). Используйте METADATA_ONLY , чтобы включить только основные метаданные (идентификатор сообщения, идентификатор ветки обсуждения, метки, метка времени и оценка размера).

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

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

Схема ввода

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

GetMessageRequest

JSON-представление 
{
  "messageId": string,
  "messageFormat": enum (MessageFormat)
}
Поля
messageId

string

Обязательно. Уникальный идентификатор сообщения, которое необходимо получить.

messageFormat

enum ( MessageFormat )

Необязательный параметр. Задает формат возвращаемого сообщения. По умолчанию используется формат FULL_CONTENT.

MessageFormat

Перечисление для управления уровнем детализации сообщений в ветке обсуждения.

Перечисления
MESSAGE_FORMAT_UNSPECIFIED По умолчанию используется значение FULL_CONTENT.
MINIMAL Возвращает фрагменты сообщений и ключевые заголовки (Тема, От, Кому, Копия, Дата).
FULL_CONTENT Возвращает всю информацию из "MINIMAL", а также полное содержимое тела каждого сообщения.
METADATA_ONLY Только метаданные: не включают тему, фрагмент текста, текст сообщения и имена файлов вложений.

Схема вывода

Сообщение в рамках ветки обсуждения.

Сообщение

JSON-представление 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
Поля
id

string

Уникальный идентификатор сообщения.

snippet

string

Фрагмент текста сообщения.

subject

string

Тема сообщения, извлеченная из заголовков:

sender

string

Адрес электронной почты отправителя.

toRecipients[]

string

Адреса электронной почты получателей.

ccRecipients[]

string

Адреса электронной почты получателей копии.

date

string

Дата сообщения в формате ISO 8601 (ГГГГ-ММ-ДД).

plaintextBody

string

Полное содержимое тела сообщения, заполняется только в том случае, если MessageFormat имеет значение FULL_CONTENT.

attachmentIds[]

string

Только для вывода. Идентификаторы вложений заполняются только в том случае, если MessageFormat имеет значение FULL_CONTENT.

htmlBody

string

HTML-содержимое электронного письма, заполняемое только в том случае, если MessageFormat имеет значение FULL_CONTENT.

attachments[]

object ( AttachmentMetadata )

Только вывод. Вложения заполняются только в том случае, если MessageFormat имеет значение FULL_CONTENT.

labelIds[]

string

Идентификаторы меток, прикрепленных к сообщению. Включает идентификаторы пользовательских меток и стандартных системных меток, ограниченных следующими: INBOX , SPAM , TRASH , UNREAD , STARRED , IMPORTANT , SENT , DRAFT , CHAT .

Метаданные вложения

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

string

Только вывод. Идентификатор вложения.

mimeType

string

MIME-тип вложения.

filename

string

Имя файла вложения.

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

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

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

Требуется один из следующих диапазонов аутентификации 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.metadata