Google Workspace MCP Server
Один MCP-сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Контактов, Chat и Apps Script с OAuth 2.1
Установка
export GOOGLE_OAUTH_CLIENT_ID="..."
export GOOGLE_OAUTH_CLIENT_SECRET="..."
uvx workspace-mcp --tool-tier coreУровни: core, extended, complete. Отдельные сервисы: --tools gmail drive calendar.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к двенадцати сервисам Google Workspace. Агент ищет и отправляет письма, работает с черновиками и ярлыками, управляет событиями календаря, файлами Диска, редактирует документы, таблицы и презентации, создает формы и читает ответы, ведет задачи и контакты, пишет и запускает Apps Script. Набор инструментов делится на уровни core, extended и complete, можно выбрать отдельные сервисы и включить режим только для чтения. Сервер работает через stdio или Streamable HTTP с многопользовательской авторизацией, есть CLI для вызова инструментов из скриптов.
Для кого. Для тех, кто работает в Google Workspace и хочет поручать агенту почту, календарь и документы.
Подходит, если
- Нужно разобрать непрочитанные письма и подготовить черновики ответов
- Нужно найти свободное время и создать встречу
- Нужно собрать данные из таблицы в документ или презентацию
Не подходит, если
- Почта и документы в Яндекс 360 или другом сервисе
- Нельзя создать OAuth-клиент в Google Cloud
Пример запроса к агенту
Найди непрочитанные письма от клиентов за неделю и создай встречу с каждым на следующей неделеОграничения
Нужен собственный OAuth-клиент в Google Cloud Console с включенными API. Google Chat требует аккаунта Workspace и отдельной настройки. Доступность Google Cloud и части API из России нестабильна. Для Claude Desktop рекомендован HTTP-режим с подключением как Connector.
Как отключить. Выполните claude mcp remove workspace-mcp, остановите сервер и отзовите доступ приложения в настройках безопасности аккаунта Google.
MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| GOOGLE_OAUTH_CLIENT_ID обязательная | ID OAuth-клиента Google Cloud |
| GOOGLE_OAUTH_CLIENT_SECRET обязательная, секрет | Секрет OAuth-клиента |
| MCP_ENABLE_OAUTH21 | Включает режим OAuth 2.1 для HTTP |
| WORKSPACE_MCP_PORT | Порт HTTP-сервера |
| GOOGLE_OAUTH_REDIRECT_URI | Адрес возврата OAuth |
Проверка безопасности
- Отправляет письма, меняет документы и календарь от имени пользователя
- Хранит OAuth-токены с широким доступом к аккаунту
Коротко о README
README описывает охват сервисов, уровни инструментов и два режима авторизации: конфиденциальный клиент и OAuth 2.1 с PKCE. Приведены команды запуска через uvx и подключение к Claude Code, Claude Desktop и ChatGPT. Разделы о безопасности объясняют, что данные уходят только в API Google. Подробные инструкции по развертыванию, прокси и переменным окружения вынесены на сайт документации. Лицензия MIT.
Частые вопросы
Отправляет ли сервер данные кому-то кроме Google?
По словам автора, нет: телеметрии нет, трассировка OpenTelemetry выключена, пока вы ее не настроите.
Как уменьшить число инструментов?
Выберите уровень --tool-tier core, укажите сервисы через --tools или отключите лишнее через --disabled-tools.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании