MCP Tools Reference: gmailmcp.googleapis.com

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

Отображает переписку по электронной почте из учетной записи Gmail авторизованного пользователя.

Этот инструмент позволяет фильтровать ветки обсуждений на основе строки запроса и поддерживает пагинацию. Он возвращает список веток, включая их идентификаторы и связанные сообщения. Каждое связанное сообщение содержит подробную информацию, такую ​​как фрагмент текста сообщения, тема, отправитель, получатели и т. д. Обратите внимание, что этот инструмент не возвращает полные тексты сообщений; при необходимости используйте инструмент 'get_thread' с идентификатором ветки, чтобы получить полный текст сообщения.

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

Запрос Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

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

SearchThreadsRequest

JSON-представление 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Поля

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

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

pageSize

integer

Необязательный параметр. Максимальное количество потоков для возврата. Если не указано, по умолчанию используется 20. Максимально допустимое значение — 50.

Поле объединения _page_token .

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

pageToken

string

Необязательный параметр. Токен страницы для получения конкретной страницы результатов в списке. Оставьте поле пустым, чтобы получить первую страницу.

Объединение полей _query .

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

query

string

Необязательно. Строка запроса для фильтрации цепочек сообщений, использующая тот же формат, что и строка поиска Gmail. Если опущено, отображаются все цепочки сообщений (по умолчанию исключая спам и корзину). Ключевые операторы: from: - Сообщения от конкретного отправителя. Кому: - Сообщения, отправленные конкретному получателю. Тема: - Сообщения, содержащие определенные слова в теме. - Сообщения, содержащие определенные слова в тексте или теме. is:unread - Непрочитанные сообщения. is:starred - Помеченные звездочкой сообщения. has:attachment - Сообщения с вложениями. after:YYYY/MM/DD - Сообщения, отправленные после даты. before:YYYY/MM/DD - Сообщения, отправленные до даты. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

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

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

includeTrash

boolean

Необязательно. Включать черновики из корзины в результаты. По умолчанию — false.

Схема вывода

Ответное сообщение для RPC-запроса SearchThreads.

SearchThreadsResponse

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

object ( Thread )

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

nextPageToken

string

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

Нить

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
}
Поля
id

string

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

snippet

string

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

subject

string

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

sender

string

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

toRecipients[]

string

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

ccRecipients[]

string

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

date

string

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

plaintextBody

string

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

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

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