MCP Reference: gmailmcp.googleapis.com

Сервер протокола контекста модели (MCP) выступает в качестве прокси-сервера между внешним сервисом, предоставляющим контекст, данные или возможности для приложения, использующего большие языковые модели (LLM) или искусственного интеллекта. Серверы MCP соединяют приложения ИИ с внешними системами, такими как базы данных и веб-сервисы, преобразуя их ответы в формат, понятный приложению ИИ.

Инструменты MCP

Инструмент MCP — это функция или исполняемый файл, который сервер MCP предоставляет приложению LLM или AI для выполнения действий в реальном мире.

Сервер MCP gmailmcp.googleapis.com располагает следующими инструментами:

Инструменты MCP
создать_черновик

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

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

список_черновиков

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

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

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

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

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

label_thread

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

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

Если вы не уверены в идентификаторе пользовательской метки, сначала воспользуйтесь инструментом list_labels , чтобы узнать доступные метки и их идентификаторы.

unlabel_thread Удаляет метки из всей ветки обсуждений в учетной записи Gmail авторизованного пользователя. Если идентификатор ветки неизвестен, сначала воспользуйтесь инструментом search_threads . Если идентификатор метки пользователя неизвестен, сначала воспользуйтесь инструментом list_labels .
list_labels Этот инструмент отображает все пользовательские метки, доступные в учетной записи Gmail авторизованного пользователя. Используйте его, чтобы узнать id пользовательской метки перед вызовом label_thread , unlabel_thread , label_message или unlabel_message . Системные метки не возвращаются этим инструментом, но могут использоваться с их общеизвестными идентификаторами: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'.
label_message

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

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

unlabel_message Удаляет одну или несколько меток из конкретного сообщения в учетной записи Gmail авторизованного пользователя. Чтобы найти идентификатор сообщения, используйте такие инструменты, как search_threads или get_thread . Если вы не уверены в идентификаторе метки пользователя, сначала воспользуйтесь инструментом list_labels , чтобы найти доступные метки и их идентификаторы.
создать_метку Создает новую метку в учетной записи Gmail авторизованного пользователя.

Получить технические характеристики инструмента MCP

Чтобы получить спецификации всех инструментов MCP на сервере MCP, используйте метод tools/list . В следующем примере показано, как использовать curl для вывода списка всех инструментов и их спецификаций, доступных в данный момент на сервере MCP.

Запрос Curl
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'