gmail-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает почту Gmail к ассистенту через собственный Cloudflare Worker. Позволяет читать ящики, слать письма и отвечать во всех цепочках сразу с нескольких аккаунтов.
Открыть на GitHubЧто делает gmail-mcp
Сервер работает как удалённый сервис на вашем собственном Cloudflare Worker. Он умеет искать и читать письма, отправлять новые сообщения, отвечать всем участникам с цитированием переписки, пересылать сообщения, а также обрабатывать вложенные файлы и картинки в теле письма. Каждое подключение привязывается к конкретному аккаунту Google, поэтому ассистент не перепутает ящики при выполнении инструкций.
Токены обновления хранятся в вашей базе Cloudflare OAUTH_KV, а не на серверах сторонних провайдеров. При настройке в Google Cloud Console приложение нужно перевести в статус Published, иначе Google аннулирует refresh token через 7 дней. Настройки ящика вроде автоответчика или правил фильтрации сервер не меняет: область прав gmail.settings он намеренно не запрашивает.
Какие задачи решает
- отправлять письма и отвечать всем участникам цепочки прямо из диалога с Claude Code
- искать сообщения и разбирать вложения сразу в нескольких аккаунтах Google
- работать с почтой через удалённый сервер с телефона или ноутбука без локального процесса
- сохранять черновики и управлять ярлыками без риска сброса настроек фильтров
Примеры запросов агенту
- Найди последние письма от бухгалтерии с темой «Счёт» и покажи прикреплённые файлы.
- Ответь всем в цепочке обсуждения релиза, процитируй предыдущее сообщение и подтверди дату.
- Перешли черновик отчёта коллеге и повесь на это письмо ярлык
Отправлено.
Как установить gmail-mcp
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gmail-mcp
Как развернуть gmail-mcp?
Для запуска нужны аккаунт Cloudflare, Google Cloud и установленный bun. Склонируйте репозиторий командой git clone https://github.com/mkpoli/gmail-mcp && cd gmail-mcp, выполните bun install и запустите настройку через bun run setup.
Чем gmail-mcp отличается от встроенного коннектора Claude?
Встроенная интеграция умеет только читать сообщения и создавать черновики, но не умеет отправлять почту. gmail-mcp разрешает отправку и поддерживает несколько почтовых ящиков одновременно.
Зачем публиковать приложение в Google Cloud Console?
В тестовом режиме Google сбрасывает refresh token каждые 7 дней, из-за чего связь с почтой будет рваться каждую неделю. Публикация статуса снимает это ограничение и поддерживает до 100 аккаунтов.
