Gmail·HeurisTech

Gmail MCP — подключение и инструкция

Gmail MCP от HeurisTech предоставляет агенту отправку писем через Gmail API после OAuth-настройки своего Google-приложения.

Рабочие сервисыЛокальноАвторизация

Что умеет этот сервер

01

Gmail MCP от HeurisTech предоставляет агенту отправку писем через Gmail API после OAuth-настройки своего Google-приложения.

02

В README этого небольшого проекта заявлен send_mail.

03

Сначала проверь регистрацию инструмента без отправки.

Задача для знакомства

Проверь настройку Gmail MCP и схему send_mail. Письмо не отправляй; покажи только необходимые поля.

Уточнить результат

Проверь Google account, scopes и recipient. Наличие tools/list не доказывает доставку; статус запроса Gmail и фактическую отправку проверяют отдельно.

Как подключить

Выберите подходящий способ

Подключить Gmail MCP

Скачай проект, выполни uv sync и настрой Google OAuth по README. get_refresh_token.py получает локальные token.json/refresh token. Заполни .env и зарегистрируй server.py через описанный mcp install; не копируй пример пути с server.py в качестве каталога.

Что понадобится

  • Python 3.12+, uv, Google Cloud project с Gmail API и настроенный OAuth client.
  1. 01

    Подготовь окружение

    Python 3.12+, uv, Google Cloud project с Gmail API и настроенный OAuth client.

  2. 02

    Установи и настрой

    Скачай проект, выполни uv sync и настрой Google OAuth по README. get_refresh_token.py получает локальные token.json/refresh token. Заполни .env и зарегистрируй server.py через описанный mcp install; не копируй пример пути с server.py в качестве каталога.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Первый запрос — пример для чата агента

Проверь настройку Gmail MCP и схему send_mail. Письмо не отправляй; покажи только необходимые поля.

Как проверить

Проверь Google account, scopes и recipient. Наличие tools/list не доказывает доставку; статус запроса Gmail и фактическую отправку проверяют отдельно.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Gmail

Gmail MCP от HeurisTech предоставляет агенту отправку писем через Gmail API после OAuth-настройки своего Google-приложения.

В README этого небольшого проекта заявлен send_mail. Не следует приписывать ему поиск всей почты, управление ярлыками и другие возможности сторонних Gmail MCP.

Что подготовить перед подключением

Python 3.12+, uv, Google Cloud project с Gmail API и настроенный OAuth client.

Как установить и подключить

Скачай проект, выполни uv sync и настрой Google OAuth по README. get_refresh_token.py получает локальные token.json/refresh token. Заполни .env и зарегистрируй server.py через описанный mcp install; не копируй пример пути с server.py в качестве каталога.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

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

Как проверить результат и решить проблемы

Проверь Google account, scopes и recipient. Наличие tools/list не доказывает доставку; статус запроса Gmail и фактическую отправку проверяют отдельно.

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

Ограничения

Операция отправляет настоящее письмо. Авторизационные скрипты могут печатать refresh token: не копируй такие логи в общий чат или репозиторий.

Исходники и документация

Репозиторий: HeurisTech/gmail-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Gmail

Gmail MCP от HeurisTech предоставляет агенту отправку писем через Gmail API после OAuth-настройки своего Google-приложения.
Вернуться в библиотеку