Claude Code умеет работать с Gmail через протокол MCP (Model Context Protocol). Это значит: агент может читать письма, писать черновики, сортировать входящие, отвечать по шаблону и запускать любые действия по триггеру — всё без вашего участия. Разбираем как настроить интеграцию Claude Code + Gmail пошагово.
Нужна карта для оплаты Claude Pro?
Автоматизация Gmail с Claude Code требует Pro-подписки. Российские карты не работают — оформите зарубежную за 5 минут.
Как работает интеграция Claude Code с Gmail
Claude Code подключается к Gmail через MCP (Model Context Protocol) — открытый стандарт Anthropic для интеграций AI-агентов с внешними сервисами.
Схема работы:
- MCP-сервер для Gmail устанавливается локально;
- Claude Code видит инструменты: «прочитать письма», «отправить письмо», «создать черновик»;
- Вы описываете задачу на естественном языке;
- Агент сам вызывает нужные инструменты Gmail API.
Что нужно для настройки
- Claude Pro ($20/мес) — необходим для Claude Code;
- Node.js 18+;
- Google аккаунт с Gmail;
- Google Cloud Project с Gmail API (бесплатно);
- OAuth 2.0 credentials из Google Cloud Console.
Установка Gmail MCP-сервера
Установите MCP-сервер для Gmail
npm install -g @anthropic-ai/mcp-server-gmail
Или используйте официальный Google Workspace MCP: npm install -g @google/mcp-server-gmail
Создайте конфиг Claude Code
В домашней директории создайте ~/.claude.json (или он уже есть):
Добавьте Gmail MCP
{"mcpServers": {"gmail": {"command": "mcp-server-gmail","args": ["--credentials", "~/.gmail-credentials.json"]}}}Перезапустите Claude Code
claude — в сессии должна появиться группа инструментов Gmail.
Проверьте
Наберите: Покажи мои последние 5 писем
Настройка прав Gmail API в Google Cloud
Создайте проект в Google Cloud
Откройте console.cloud.google.com → New Project.
Включите Gmail API
APIs & Services → Enable APIs → найдите Gmail API → Enable.
Создайте OAuth credentials
Credentials → Create Credentials → OAuth client ID → Desktop app.
Скачайте JSON
Сохраните как ~/.gmail-credentials.json.
Авторизуйтесь
При первом запуске MCP-сервер откроет браузер для OAuth. Разрешите доступ.
Первые автоматизации Gmail с Claude Code
После настройки попробуйте эти задачи:
Найди все непрочитанные письма от клиентов за неделю и дай краткое резюмеНапиши черновик ответа на последнее письмо от [имя] — вежливый отказСоздай метку «Срочно» и примени ко всем письмам где есть слово «дедлайн»Найди письма с вложениями PDF за последний месяц и перечисли ихНапиши шаблон еженедельного отчёта на основе писем из папки «Проекты»
Продвинутые кейсы: Claude Code как почтовый агент
При запуске из скрипта Claude Code может работать полностью автономно:
- Авто-классификация входящих — агент запускается по расписанию, читает новые письма, раскладывает по меткам;
- CRM-интеграция — пишет данные о клиентах из писем в Google Sheets или Notion;
- Авто-черновики — для типовых запросов готовит черновик ответа, вам остаётся только нажать «отправить»;
- Дайджест — каждое утро в 9:00 агент присылает сводку важных писем за ночь;
- Отслеживание треда — следит за ключевыми перепиской и уведомляет о важных ответах.
Безопасность и ограничения интеграции
- Всё локально — MCP-сервер работает на вашем компьютере, данные Gmail не уходят напрямую в Anthropic без вашего запроса;
- OAuth scope — выдавайте только нужные права (например, read-only если агент только читает);
- Лимиты Gmail API — 1 млрд API units в день для бесплатного тарифа Google Cloud, этого хватит на любое разумное использование;
- Обновление токенов — если токен истёк, MCP-сервер попросит переавторизоваться.
Как оплатить Claude Pro из России
Российские карты (Visa, Mastercard, МИР) не принимаются на сайте Anthropic. Нужна карта зарубежного банка. Два рабочих варианта:
- Плати по Миру — виртуальная карта UK-банка, выпуск за 5–10 мин, пополнение через СБП. По нашей ссылке бонус $10 на счёт.
- zarub.io — виртуальная Visa/MC через Telegram, от 490 ₽/мес.
| Вариант | Детали | |
|---|---|---|
| Плати по Миру | Виртуальная Visa/MC зарубежного банка. Выпуск 5–10 мин, пополнение СБП. Бонус $10. | Оформить |
| zarub.io (Telegram) | Виртуальная Visa/MC через @zarub_robot за 490 ₽. Для разовых подписок. | Открыть бота |