Google Workspace MCP
MCP-сервер для почты, календаря и файлов Google: агент работает с несколькими аккаунтами от вашего имени
- 197 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Сервер отправляет письма, удаляет файлы и меняет права доступа в ваших аккаунтах Google
- Токены нескольких аккаунтов с доступом к почте и документам лежат на диске
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/google-workspace-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер отправляет письма, удаляет файлы и меняет права доступа в ваших аккаунтах Google
- Токены нескольких аккаунтов с доступом к почте и документам лежат на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 12 инструментов к восьми службам Google: Gmail, Calendar, Drive, Docs, Sheets, Tasks, Meet и Contacts. Агент ищет и читает письма, отвечает и пересылает их, создает события, скачивает и загружает файлы Drive, правит таблицы и документы, ведет задачи и смотрит записи встреч. Всего доступно 95 операций из 257 методов, которые публикует Google: набор урезан намеренно, чтобы агенту было проще выбирать. В одном запросе агент связывает несколько действий: найти счет в почте, сохранить вложение на Drive и поставить задачу на пятницу. Инструмент `bulk_operations` выполняет цепочку за один вызов или применяет одну операцию к сотням писем сразу. Каждый ответ подсказывает агенту следующий шаг. Токены каждого аккаунта лежат на вашем диске, запросы идут в Google напрямую, без посредника.
Для кого. Тем, кто ведет почту, календарь и документы в нескольких аккаунтах Google и хочет передавать рутину агенту в Claude Code или Claude Desktop.
Подходит, если
- Входящие разрослись, и агент разбирает письма по меткам, а лишнее отправляет в корзину пачкой
- Рабочий и личный аккаунты подключены рядом, и агент сам выбирает нужный для каждого запроса
- Из письма со счетом нужно сохранить вложение на Drive и поставить напоминание в Tasks
- Таблицу в Sheets обновляют по строкам, а агент читает диапазон и дописывает результат
- Перед встречей агент смотрит календарь, свободное время и участников звонка в Meet
Не подходит, если
- Нужна полная выгрузка почты или администрирование домена: сервер покрывает часть методов API
- Аккаунт корпоративный, и политика запрещает собственные OAuth-приложения
- Достаточно одного чтения календаря: проще подключить готовый календарный коннектор
Пример запроса к агенту
Найди последнее письмо от Acme со счетом, сохрани вложение в папку «Счета» на Drive и поставь задачу оплатить в пятницуMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
GOOGLE_CLIENT_IDобязательная- Идентификатор OAuth-клиента Google.
GOOGLE_CLIENT_SECRETобязательная, секрет- Секрет OAuth-клиента Google.
Ограничения
Нужны собственные учетные данные OAuth: в консоли Google создают клиент типа «Desktop app», включают нужные API и передают серверу идентификатор и секрет клиента. Требуется Node.js 22.12 или новее. Сервер отправляет письма, удаляет файлы и меняет права доступа от вашего имени, поэтому у аккаунтов есть режим только для чтения, и его стоит включить, пока вы проверяете поведение агента. Расширенные методы Google вне набора из 95 операций недоступны, их можно запросить через форму в репозитории.
Как отключить. Удалите сервер в клиенте (`claude mcp remove google-workspace`) и отзовите доступ приложения в настройках аккаунта Google. Локальные токены лежат в каталоге данных сервера.
Частые вопросы
Как подключить Google Workspace MCP к Claude Code?
Создайте OAuth-клиент в консоли Google и выполните `claude mcp add google-workspace -e GOOGLE_CLIENT_ID=... -e GOOGLE_CLIENT_SECRET=... -- npx -y @aaronsb/google-workspace-mcp`. После этого `/mcp` покажет сервер, а первый запрос откроет вход в аккаунт.
Можно ли подключить несколько аккаунтов?
Да, инструмент `manage_accounts` добавляет аккаунты и их права, а сервер направляет каждый запрос в нужный. Личный и рабочий аккаунты работают рядом.
Куда попадают мои токены?
Токены каждого аккаунта хранятся на вашем диске, а запросы идут в Google напрямую. Своей службы-посредника у проекта нет.
Как установить в Claude Desktop без правки файлов?
Скачайте `google-workspace-mcp.mcpb` из последнего релиза и перетащите на окно Claude Desktop. В диалоге введите идентификатор и секрет клиента Google.
Сколько операций доступно агенту?
95 операций из 257 методов, которые публикует Google. Список всех методов с пометкой, какие подключены, лежит в `docs/api-surface.md`, а недостающий можно запросить через готовую заявку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОдин MCP-сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Контактов, Chat и Apps Script с OAuth 2.1
Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
GSuite MCP
mcp-gsuite
MCP-сервер для Gmail и Google Календаря на Python: поиск и чтение писем, черновики и ответы, события с участниками, несколько аккаунтов сразу
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Google Workspace для Gemini CLI
Google Workspace Extension for Gemini CLI
Расширение Gemini CLI для работы с Google Docs, Sheets, Slides, Gmail, Chat, Calendar и Drive из терминала
Локальный MCP-сервер для Mac и Windows: агент работает с почтой, мессенджерами, календарем и файлами.
Коротко о README
Репозиторий описывает установку через `.mcpb`, команду Claude Code и JSON-конфиг, а затем перечисляет 12 инструментов по службам Google. Отдельные разделы посвящены цепочкам действий, пакетным операциям и просьбе добавить недостающие методы.