MCP Tools Reference: gmailmcp.googleapis.com

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

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

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

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

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

Схема ввода

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

GetThreadRequest

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

string

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

messageFormat

enum ( MessageFormat )

Необязательный параметр. Задает формат сообщений, возвращаемых в ветке обсуждения. По умолчанию используется формат FULL_CONTENT. Примечание: формат MINIMAL возвращает id, snippet, subject, from, to, cc, date, labelIds. Формат METADATA_ONLY возвращает id, from, to, cc, date, labelIds. Формат FULL_CONTENT возвращает id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments.

MessageFormat

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

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

Схема вывода

Поток сообщений, содержащий список сообщений.

Нить

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

string

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

messages[]

object ( Message )

Список сообщений в ветке обсуждения, упорядоченный в хронологическом порядке.

Сообщение

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