MCP Tools Reference: gmailmcp.googleapis.com

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

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

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

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

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

Схема ввода

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

Запрос на создание списка черновиков

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

  "pageSize": integer

  "pageToken": string

  "query": string
}
Поля

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

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

pageSize

integer

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

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

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

pageToken

string

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

Объединение полей _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"

Схема вывода

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

ListDraftsResponse

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

object ( Draft )

Список черновиков.

nextPageToken

string

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

Черновик

JSON-представление 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Поля
id

string

Уникальный идентификатор чернового варианта ресурса.

subject

string

Тема черновика сообщения.

threadId

string

Идентификатор темы, к которой относится этот черновик.

toRecipients[]

string

Список адресов электронной почты получателей, извлеченных из заголовков.

ccRecipients[]

string

Список адресов электронной почты получателей, указанных в поле «Копия», извлеченных из заголовков.

bccRecipients[]

string

Список адресов электронной почты получателей, указанных в поле «Скрытая копия» (Bcc), извлеченных из заголовков.

plaintextBody

string

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

date

string

Дата проекта в формате ISO 8601 (ГГГГ-ММ-ДД).

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

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