Gmail AutoAuth MCP-сервер

Сервер Model Context Protocol (MCP) для интеграции Gmail в Claude Desktop с поддержкой автоматической аутентификации. Этот сервер позволяет помощникам ИИ управлять Gmail посредством взаимодействия на естественном языке.

Функции

• Отправка электронных писем с темой, содержанием, вложениями и получателями

• Полная поддержка международных символов в темах и содержимом писем

• Чтение сообщений электронной почты по идентификатору с расширенной обработкой структуры MIME

• Просмотр информации о вложениях электронной почты (имена файлов, типы, размеры)

• Поиск писем по различным критериям (тема, отправитель, диапазон дат)

• Комплексное управление этикетками с возможностью создания, обновления, удаления и составления списка этикеток

• Список всех доступных ярлыков Gmail (системных и пользовательских)

• Список писем в папке «Входящие», «Отправленные» или с пользовательскими метками

• Отметить письма как прочитанные/непрочитанные

• Перемещать электронные письма в разные метки/папки

• Удалить электронные письма

• Пакетные операции для эффективной обработки нескольких писем одновременно

• Полная интеграция с API Gmail

• Простой процесс аутентификации OAuth2 с автоматическим запуском браузера

• Поддержка учетных данных как настольных, так и веб-приложений

• Глобальное хранилище учетных данных для удобства

Related MCP server: Enhanced Gmail MCP Server

Установка и аутентификация

Установка через Smithery

Чтобы автоматически установить Gmail AutoAuth для Claude Desktop через Smithery :

Установка вручную

1. Создайте проект Google Cloud и получите учетные данные:

   а. Создайте проект Google Cloud:

   • Перейти в Google Cloud Console

   • Создайте новый проект или выберите существующий

   • Включите API Gmail для вашего проекта

   б) Создайте учетные данные OAuth 2.0:

   • Перейдите в раздел «API и службы» > «Учетные данные».

   • Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth».

   • Выберите тип приложения: «Приложение для настольного компьютера» или «Веб-приложение».

   • Дайте ему имя и нажмите «Создать».

   • Для веб-приложения добавьте http://localhost:3000/oauth2callback к разрешенным URI перенаправления.

   • Загрузите JSON-файл ключей OAuth вашего клиента

   • Переименуйте файл ключа в gcp-oauth.keys.json

2. Запустить аутентификацию:

   Аутентификацию можно пройти двумя способами:

   а. Глобальная аутентификация (рекомендуется):

   # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder mkdir -p ~/.gmail-mcp mv gcp-oauth.keys.json ~/.gmail-mcp/ # Run authentication from anywhere npx @gongrzhe/server-gmail-autoauth-mcp auth

   б) Локальная аутентификация:

   # Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @gongrzhe/server-gmail-autoauth-mcp auth

   Процесс аутентификации будет:

   • Найдите gcp-oauth.keys.json в текущем каталоге или ~/.gmail-mcp/

   • Если файл найден в текущем каталоге, скопируйте его в ~/.gmail-mcp/

   • Откройте браузер по умолчанию для аутентификации Google

   • Сохраните учетные данные как ~/.gmail-mcp/credentials.json

   Примечание :

   • После успешной аутентификации учетные данные сохраняются глобально в ~/.gmail-mcp/ и могут быть использованы из любого каталога.

   • Поддерживаются учетные данные как настольного приложения, так и веб-приложения.

   • Для учетных данных веб-приложения обязательно добавьте http://localhost:3000/oauth2callback к вашим авторизованным URI перенаправления.

3. Настройте в Claude Desktop:

Поддержка докера

Если вы предпочитаете использовать Docker:

1. Аутентификация:

2. Использование:

Аутентификация облачного сервера

Для облачных серверных сред (например, n8n) вы можете указать пользовательский URL-адрес обратного вызова во время аутентификации:

Инструкции по настройке облачной среды

1. Настроить обратный прокси-сервер:

   • Настройте контейнер n8n для предоставления порта для аутентификации

   • Настройте обратный прокси-сервер для пересылки трафика с вашего домена (например, gmail.gongrzhe.com ) на этот порт

2. Конфигурация DNS:

   • Добавьте запись A в настройки DNS, чтобы преобразовать ваш домен в IP-адрес вашего облачного сервера.

3. Настройка облачной платформы Google:

   • В консоли Google Cloud Console добавьте URL-адрес обратного вызова вашего домена (например, https://gmail.gongrzhe.com/oauth2callback ) в список разрешенных URI перенаправления.

4. Запустить аутентификацию:

   npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback

5. Настройте в своем приложении:

   { "mcpServers": { "gmail": { "command": "npx", "args": [ "@gongrzhe/server-gmail-autoauth-mcp" ] } } }

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

Доступные инструменты

Сервер предоставляет следующие инструменты, которые можно использовать через Claude Desktop:

1. Отправить электронное письмо ( send_email )

Немедленно отправляет новое электронное письмо.

2. Черновик электронного письма ( draft_email )

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

3. Прочитать письмо ( read_email )

Извлекает содержимое определенного электронного письма по его идентификатору.

4. Поиск писем ( search_emails )

Поиск писем с использованием синтаксиса поиска Gmail.

5. Изменить адрес электронной почты ( modify_email )

Добавляет или удаляет метки из писем (перемещать в другие папки, архивировать и т. д.).

6. Удалить электронное письмо ( delete_email )

Удаляет электронное письмо навсегда.

7. Список меток электронной почты ( list_email_labels )

Извлекает все доступные ярлыки Gmail.

8. Создать метку ( create_label )

Создает новый ярлык Gmail.

9. Обновить метку ( update_label )

Обновляет существующий ярлык Gmail.

10. Удалить метку ( delete_label )

Удаляет ярлык Gmail.

11. Получить или создать метку ( get_or_create_label )

Получает существующую метку по имени или создает ее, если она не существует.

12. Пакетное изменение писем ( batch_modify_emails )

Эффективно изменяет метки для нескольких писем пакетами.

13. Пакетное удаление писем ( batch_delete_emails )

Окончательно удаляет несколько писем эффективными пакетами.

Синтаксис расширенного поиска

Инструмент search_emails поддерживает мощные операторы поиска Gmail:

Вы можете объединить несколько операторов: from:john@example.com after:2024/01/01 has:attachment

Расширенные функции

Извлечение содержимого электронной почты

Сервер интеллектуально извлекает содержимое электронной почты из сложных структур MIME:

• Приоритет отдается обычному текстовому контенту, если он доступен

• Возвращается к HTML-контенту, если простой текст недоступен

• Обрабатывает многокомпонентные сообщения MIME с вложенными частями

• Обрабатывает информацию о вложениях (имя файла, тип, размер)

• Сохраняет оригинальные заголовки писем (От, Кому, Тема, Дата)

Поддержка международного характера

Сервер полностью поддерживает символы, не входящие в набор ASCII, в темах и содержимом электронных писем, включая:

• Турецкий, китайский, японский, корейский и другие нелатинские алфавиты

• Специальные знаки и символы

• Правильная кодировка обеспечивает корректное отображение в почтовых клиентах.

Комплексное управление этикетками

Сервер предоставляет полный набор инструментов для управления ярлыками Gmail:

• Создание меток : создание новых меток с настраиваемыми параметрами видимости.

• Обновление меток : переименование меток или изменение настроек их видимости.

• Удалить метки : удалить метки, созданные пользователем (системные метки защищены)

• Найти или создать : получить метку по имени или автоматически создать ее, если она не найдена

• Список всех меток : просмотр всех системных и пользовательских меток с подробной информацией.

• Параметры видимости меток : управление отображением меток в сообщениях и списках меток.

Настройки видимости меток включают в себя:

• messageListVisibility : управляет отображением метки в списке сообщений ( show или hide )

• labelListVisibility : управляет тем, как отображается метка в списке меток ( labelShow , labelShowIfUnread или labelHide ).

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

Пакетные операции

Сервер включает в себя эффективные возможности пакетной обработки:

• Обрабатывать до 50 писем одновременно (размер пакета можно настраивать)

• Автоматическое разделение больших наборов электронных писем на части для обхода ограничений API

• Подробный отчет об успехах/неудачах для каждой операции

• Грамотная обработка ошибок с индивидуальными повторными попытками

• Идеально подходит для управления массовыми входящими сообщениями и задач по организации

Заметки о безопасности

• Учетные данные OAuth надежно хранятся в вашей локальной среде ( ~/.gmail-mcp/ )

• Сервер использует автономный доступ для поддержания постоянной аутентификации.

• Никогда не передавайте и не передавайте свои учетные данные в систему контроля версий.

• Регулярно проверяйте и отзывайте неиспользуемый доступ в настройках вашего аккаунта Google.

• Учетные данные хранятся глобально, но доступны только текущему пользователю.

Поиск неисправностей

1. Ключи OAuth не найдены

   • Убедитесь, что gcp-oauth.keys.json находится либо в вашем текущем каталоге, либо в ~/.gmail-mcp/

   • Проверьте права доступа к файлу

2. Неверный формат учетных данных

   • Убедитесь, что ваш файл ключей OAuth содержит web или installed учетные данные.

   • Для веб-приложений проверьте правильность настройки URI перенаправления.

3. Порт уже используется

   • Если порт 3000 уже используется, освободите его перед запуском аутентификации.

   • Вы можете найти и остановить процесс, используя этот порт.

4. Сбои пакетной обработки

   • Если пакетные операции не выполняются, они автоматически повторяют отдельные элементы.

   • Проверьте подробные сообщения об ошибках на предмет конкретных сбоев.

   • Рассмотрите возможность уменьшения размера партии, если вы столкнулись с ограничением скорости.

Внося вклад

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

Лицензия

Массачусетский технологический институт

Поддерживать

Если у вас возникли какие-либо проблемы или есть вопросы, пожалуйста, сообщите о проблеме в репозитории GitHub.