Enables complete email management through Gmail, including sending emails with attachments, reading and searching emails, managing labels and organization, handling drafts, and performing batch operations on multiple emails.
Integrates with Google Cloud for authentication and API access, allowing the MCP server to securely connect to Gmail services through OAuth 2.0 credentials.
Мощный сервер Model Context Protocol (MCP), позволяющий Claude AI напрямую взаимодействовать с Gmail.
Gmail MCP Server — это комплексная реализация, которая позволяет помощникам ИИ, таким как Клод, напрямую взаимодействовать с Gmail посредством естественного языка. Он предоставляет богатый набор инструментов для управления электронной почтой, обеспечивая бесшовную интеграцию между разговорным ИИ и вашим почтовым ящиком.
credentials.json в корне проектаЗапустите сервер один раз для аутентификации:
Это откроет окно браузера, предлагающее вам пройти аутентификацию с помощью вашего аккаунта Google. После аутентификации будет создан файл token.json , который будет сохранен для будущего использования.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonПримечание: замените "/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 — Поиск писем с использованием синтаксиса запросов Gmailget_email_labels — список всех ярлыков/папок Gmailcreate_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 — Получить информацию профиля Gmailsummarize_recent_emails — создать сводку последних писемВот несколько примеров подсказок для Клода:
Сервер поддерживает несколько переменных среды для настройки:
| Переменная | Описание |
|---|---|
GMAIL_TOKEN_PATH | Пользовательский путь для хранения токена OAuth |
GMAIL_CREDENTIALS_PATH | Пользовательский путь к учетным данным OAuth |
GOOGLE_CLIENT_ID | Идентификатор клиента OAuth (альтернатива файлу учетных данных) |
GOOGLE_CLIENT_SECRET | Секрет клиента OAuth (альтернатива файлу учетных данных) |
MCP_PORT | Порт для транспорта SSE (по умолчанию: 3000) |
DEBUG | Включить режим отладки ( true или false ) |
Сервер может работать в режиме SSE (Server-Sent Events) для интеграции на основе HTTP:
Это запустит сервер на указанном порту (по умолчанию: 3000), сделав его доступным по протоколу HTTP.
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
git checkout -b feature/amazing-feature )git commit -m 'Add some amazing feature' )git push origin feature/amazing-feature )Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
This server cannot be installed
Сервер Model Context Protocol, который позволяет Claude AI взаимодействовать с Gmail, поддерживая отправку, чтение, поиск, маркировку, управление черновиками и пакетные операции с помощью команд на естественном языке.