Сервер Gmail MCP

Мощный сервер Model Context Protocol (MCP), позволяющий Claude AI напрямую взаимодействовать с Gmail.

📖 Содержание

• Обзор

• Основные характеристики

• Быстрый старт

  • Предпосылки

  • Установка

  • Настройте учетные данные Google Cloud и OAuth

  • Первый запуск и аутентификация

  • Настроить рабочий стол Клода

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

• Примеры использования

• Расширенная конфигурация

  • Переменные среды

  • Режим сервера SSE

• Документация

• Соображения безопасности

• Внося вклад

• Лицензия

• Благодарности

Related MCP server: GCP MCP

📋 Обзор

Gmail MCP Server — это комплексная реализация, которая позволяет помощникам ИИ, таким как Клод, напрямую взаимодействовать с Gmail посредством естественного языка. Он предоставляет богатый набор инструментов для управления электронной почтой, обеспечивая бесшовную интеграцию между разговорным ИИ и вашим почтовым ящиком.

💡 Основные характеристики

• Полное управление электронной почтой

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

  • Читайте электронные письма с правильным анализом сложных структур сообщений.

  • Поиск входящих сообщений с помощью мощного синтаксиса запросов Gmail

  • Создавайте и обновляйте черновики писем

  • Управление метками, статусом прочитанного/непрочитанного и корзиной

  • Выполнение пакетных операций над несколькими электронными письмами

• Расширенная интеграция

  • Современная кодовая база Python с шаблоном async/await

  • Комплексная обработка ошибок и восстановление

  • Подробный отчет о ходе работ

  • Безопасный процесс аутентификации OAuth

  • Несколько транспортных режимов (STDIO и SSE)

  • Поддержка различных сценариев развертывания

🚀 Быстрый старт

Предпосылки

• Python 3.8 или выше

• Проект Google Cloud с включенным API Gmail

• Учетные данные OAuth 2.0 для API Gmail

Установка

1. Клонировать репозиторий

   git clone https://github.com/yourusername/gmail-mcp-server.git cd gmail-mcp-server

2. Настройте виртуальную среду

   python -m venv venv # On Windows venv\Scripts\activate # On macOS/Linux source venv/bin/activate

3. Установить зависимости

   pip install -r requirements.txt

4. Настройте учетные данные Google Cloud и OAuth

   Посетите Google Cloud Console , чтобы:

   • Создать новый проект

   • Включить API Gmail

   • Настройте экран согласия OAuth

   • Создание учетных данных OAuth Client ID (настольное приложение)

   • Загрузите учетные данные как credentials.json в корне проекта

Первый запуск и аутентификация

Запустите сервер один раз для аутентификации:

Это откроет окно браузера, предлагающее вам пройти аутентификацию с помощью вашего аккаунта Google. После аутентификации будет создан файл token.json , который будет сохранен для будущего использования.

Настроить рабочий стол Клода

1. Отредактируйте файл конфигурации Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Добавьте сервер Gmail MCP в конфигурацию:

   { "mcpServers": { "gmail": { "command": "python", "args": [ "/absolute/path/to/gmail-mcp-server/gmail_server.py" ] } } }

3. Сохраните файл и перезапустите Claude Desktop.

Примечание: замените "/absolute/path/to/gmail-mcp-server/gmail_server.py" фактическим абсолютным путем к файлу gmail_server.py в клонированном репозитории.

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

Сервер Gmail MCP предоставляет Клоду следующие инструменты:

Отправка электронной почты

• send_email — отправка простых писем с текстовым/HTML-контентом

• send_email_with_attachment — отправлять электронные письма с прикрепленными файлами

• send_email_with_multiple_attachments — отправлять электронные письма с несколькими вложениями

Чтение электронной почты

• read_email - Прочитать содержимое определенного электронного письма по идентификатору

• get_unread_emails — Получить список непрочитанных писем

• get_important_emails — Получайте письма, отмеченные как важные

• get_emails_with_attachments — Получить электронные письма с вложениями

• get_recent_emails — Получить письма за последние X дней

Поиск и организация электронной почты

• search_emails — Поиск писем с использованием синтаксиса запросов Gmail

• get_email_labels — список всех ярлыков/папок Gmail

• create_email_label — Создать новый ярлык

• delete_email_label — Удалить существующую метку

• label_email — применить метку к электронному письму

• remove_email_label — Удалить метку из электронного письма

Управление статусом электронной почты

• mark_as_read — Отметить письмо как прочитанное

• mark_as_unread — Отметить письмо как непрочитанное

• delete_email — Переместить письмо в корзину

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

• create_email_draft — создать новый черновик электронного письма

• update_email_draft — обновить существующий черновик

• list_email_drafts — Список доступных черновиков

• send_draft — Отправить существующий черновик

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

• batch_apply_label — применить метку к нескольким письмам

• batch_delete_emails — Переместить несколько писем в корзину

Информация об учетной записи

• get_email_profile — Получить информацию профиля Gmail

• summarize_recent_emails — создать сводку последних писем

💬 Примеры использования

Вот несколько примеров подсказок для Клода:

🔧 Расширенная конфигурация

Переменные среды

Сервер поддерживает несколько переменных среды для настройки:

Режим сервера SSE

Сервер может работать в режиме SSE (Server-Sent Events) для интеграции на основе HTTP:

Это запустит сервер на указанном порту (по умолчанию: 3000), сделав его доступным по протоколу HTTP.

📚 Документация

• Спецификация MCP — узнайте больше о протоколе контекста модели

• Документация API Gmail — Справочник по возможностям API Gmail

• Google Cloud OAuth — подробности о процессах аутентификации

🔒 Вопросы безопасности

• Сервер использует OAuth 2.0 для безопасной аутентификации API Gmail.

• Все действия выполняются локально на вашем компьютере — электронные письма никогда не проходят через сторонние серверы.

• Токены аутентификации хранятся локально и могут быть отозваны в любое время.

• Доступ к локальному файлу требуется только для чтения вложений.

• Клод всегда запрашивает подтверждение перед отправкой или удалением писем.

🤝 Вклад

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

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение

📝 Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

🙏 Благодарности

• Google для API Gmail

• Антропный для Клода и модельного контекстного протокола

• Участники клиентских библиотек Python Gmail API