Gmail MCP

Gmail MCP

Реализация протокола контекста модели (MCP) для API Gmail , предоставляющая стандартизированный интерфейс для управления электронной почтой, ее отправки и извлечения.

Функции

• Полный охват API Gmail, включая сообщения, темы, метки, черновики и настройки
• Поддержка отправки, составления и управления электронными письмами
• Управление этикетками с настраиваемыми цветами и параметрами видимости
• Операции с потоками для управления беседами
• Управление настройками, включая автоответчик, IMAP/POP и языковые настройки
• Отслеживание истории изменений почтового ящика
• Безопасная аутентификация OAuth2 с использованием учетных данных Google Cloud

Предпосылки

Чтобы запустить этот сервер MCP, вам сначала необходимо настроить клиент Google API для вашей организации, при этом каждый пользователь должен запустить скрипт для получения собственного токена обновления OAuth.

Настройка клиента Google API (один раз для каждой организации)

1. Перейдите в Google Cloud Console .
2. Создайте новый проект или выберите существующий.
3. Включите API Gmail для вашего проекта.
4. Перейдите в раздел «Учетные данные» и создайте идентификатор клиента OAuth 2.0. Выберите «Приложение для настольного компьютера» в качестве типа клиента.
5. Загрузите и сохраните ключи OAuth JSON как ~/.gmail-mcp/gcp-oauth.keys.json .
6. (Необязательно) Для удаленной установки сервера (например, с помощью Smithery CLI) запишите CLIENT_ID и CLIENT_SECRET из этого файла.

Клиентский OAuth (один раз для каждого пользователя)

1. Попросите пользователя скопировать ~/.gmail-mcp/gcp-oauth.keys.json на свой компьютер по тому же пути.
2. Запустите npx @shinzolabs/gmail-mcp auth .
3. Откроется окно браузера, в котором пользователь может выбрать профиль, просмотреть запрошенные области действия и одобрить их.
4. (Необязательно) Для удаленной установки сервера обратите внимание на путь к файлу, указанный в сообщении об успешном завершении (по умолчанию ~/.gmail-mcp/credentials.json ). REFRESH_TOKEN пользователя будет найден здесь.

Конфигурация клиента

Существует несколько вариантов настройки клиента MCP с сервером. Для настройки размещенного/удалённого сервера используйте CLI Smithery с ключом API Smithery . Для локальной установки используйте npx или сборку из исходников. Каждый из этих вариантов поясняется ниже.

Удаленный сервер Smithery (рекомендуется)

Чтобы добавить удаленный сервер в config.json вашего клиента MCP, выполните следующую команду из Smithery CLI :

При появлении соответствующего запроса введите CLIENT_ID , CLIENT_SECRET и REFRESH_TOKEN .

Кузнечное дело SDK

Если вы разрабатываете собственное приложение-агент, вы можете использовать шаблонный код здесь .

Локальная установка NPX

Чтобы установить сервер локально с помощью npx , добавьте следующее в config.json вашего клиента MCP:

Сборка из исходного кода

1. Загрузить репозиторий:

2. Установите пакеты и соберите их с помощью pnpm (внутри клонированного репозитория):

3. Добавьте следующее в config.json вашего клиента MCP:

Конфигурационные переменные

Поддерживаемые конечные точки

Управление пользователями

• get_profile : Получить профиль Gmail текущего пользователя
• stop_mail_watch : Прекратить получать push-уведомления
• watch_mailbox : Настройка push-уведомлений об изменениях в почтовом ящике

Управление сообщениями

Управление сообщениями

• list_messages : Список сообщений с дополнительной фильтрацией
• get_message : Получить определенное сообщение
• get_attachment : Получить вложение к сообщению
• modify_message : Изменить метки сообщений
• send_message : Отправить сообщение электронной почты указанным получателям
• delete_message : Удалить сообщение навсегда
• trash_message : Переместить сообщение в корзину
• untrash_message : Удалить сообщение из корзины
• batch_modify_messages : Изменить несколько сообщений
• batch_delete_messages : Удалить несколько сообщений

Управление этикетками

• list_labels : Список всех меток
• get_label : Получить определенную метку
• create_label : Создать новую метку
• update_label : Обновить метку
• patch_label : Частичное обновление метки
• delete_label : Удалить метку

Управление потоками

• list_threads : Список тем электронной почты
• get_thread : Получить определенную ветку
• modify_thread : Изменить метки потоков
• trash_thread : Переместить тему в корзину
• untrash_thread : Удалить тему из корзины
• delete_thread : Удалить тему

Управление проектом

• list_drafts : Список черновиков в почтовом ящике пользователя
• get_draft : Получить конкретный черновик по идентификатору
• create_draft : Создать черновик письма в Gmail
• update_draft : Заменить содержимое черновика
• delete_draft : Удалить черновик
• send_draft : Отправить существующий черновик

Управление настройками

Автоматическая пересылка

• get_auto_forwarding : Получить настройки автоматической пересылки
• update_auto_forwarding : Обновить настройки автоматической пересылки

Настройки IMAP

• get_imap : Получить настройки IMAP
• update_imap : Обновить настройки IMAP

Настройки POP-протокола

• get_pop : Получить настройки POP
• update_pop : Обновить настройки POP

Ответчик на отпуск

• get_vacation : Получить настройки автоответчика на время отпуска
• update_vacation : Обновление ответчика об отпуске

Настройки языка

• get_language : Получить языковые настройки
• update_language : Обновить языковые настройки

Делегаты

• list_delegates : Список делегатов аккаунта
• get_delegate : Получить определенного делегата
• add_delegate : Добавить делегата
• remove_delegate : Удалить делегата

Фильтры

• list_filters : Список фильтров электронной почты
• get_filter : Получить определенный фильтр
• create_filter : Создать новый фильтр
• delete_filter : Удалить фильтр

Адреса для пересылки

• list_forwarding_addresses : Список адресов пересылки
• get_forwarding_address : Получить определенный адрес пересылки
• create_forwarding_address : Создать адрес пересылки
• delete_forwarding_address : Удалить адрес пересылки

Настройки «Отправить как»

• list_send_as : Список псевдонимов send-as
• get_send_as : Получить определенный псевдоним send-as
• create_send_as : Создать псевдоним send-as
• update_send_as : Обновить псевдоним send-as
• patch_send_as : Частичное обновление псевдонима send-as
• verify_send_as : Отправить письмо с подтверждением
• delete_send_as : Удалить псевдоним send-as

Настройки S/MIME

• list_smime_info : Список конфигураций S/MIME
• get_smime_info : Получить определенную конфигурацию S/MIME
• insert_smime_info : загрузить новую конфигурацию S/MIME
• set_default_smime_info : Установить конфигурацию S/MIME по умолчанию
• delete_smime_info : Удалить конфигурацию S/MIME

Внося вклад

Вклады приветствуются и поощряются! Пожалуйста, прочтите CONTRIBUTING.md для получения инструкций по вопросам, вкладам и контактной информации.