Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
- 678 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает права на чтение и запись документов и Drive, на отправку писем (gmail.modify) и на изменение событий календаря (calendar.events)
- Инструменты удаляют данные: deleteFile может удалить файл насовсем, deleteDraft и deleteEvent необратимы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/google-docs-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает права на чтение и запись документов и Drive, на отправку писем (gmail.modify) и на изменение событий календаря (calendar.events)
- Инструменты удаляют данные: deleteFile может удалить файл насовсем, deleteDraft и deleteEvent необратимы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает Claude Desktop, Cursor, Windsurf и другие клиенты MCP к набору сервисов Google. Для Docs есть чтение в виде текста, JSON или markdown, вставка и замена текста, поиск, вкладки документа, стили, таблицы, изображения и замена содержимого markdown-текстом, а также комментарии. Для Sheets доступны чтение и запись диапазонов, добавление строк, листы, форматирование и таблицы. Для Drive есть поиск, создание папок, перемещение, копирование, переименование и скачивание файлов. Gmail дает поиск и чтение писем, отправку, черновики, метки и инструмент triageInbox для разбора непрочитанных. Calendar позволяет искать, создавать, менять и удалять события, в том числе из фразы вроде «обед с Сарой завтра в 12». Отдельная группа инструментов управляет проектами Apps Script. Группы включаются переменной MCP_TOOL_GROUPS (docs, drive, sheets, utils, gmail, calendar, script), так что почту и календарь можно не подключать.
Для кого. Для тех, кто ведет документы, таблицы, почту и календарь в Google и хочет поручить рутину Claude или другому агенту.
Подходит, если
- Нужно прочитать документ Google Docs и переписать абзацы, оставив форматирование
- Агент должен собрать таблицу в Sheets из данных диалога и оформить ее
- Требуется разобрать непрочитанные письма и подготовить черновики ответов, не отправляя их сразу
- Нужно найти файлы в Drive по содержимому и разложить по папкам
- Событие надо создать из одной фразы или перенести встречу в Calendar
Не подходит, если
- Нужны только Docs без доступа к почте: оставьте группы docs, drive и sheets через MCP_TOOL_GROUPS
- Нужна безвозвратная очистка почты: сервер только отправляет письма в корзину, жесткое удаление не реализовано
- Нужны вложения из полученных писем: getMessage отдает только метаданные
- Письма должны уходить в HTML: sendEmail отправляет простой текст
- Нельзя выдавать агенту права на почту и календарь с областями gmail.modify и calendar.events
Пример запроса к агенту
Найди в Drive документ «Квартальный план», прочитай его и добавь в конец раздел с итогами в виде таблицыMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
GOOGLE_CLIENT_IDобязательная- Идентификатор клиента OAuth из Google Cloud.
GOOGLE_CLIENT_SECRETобязательная, секрет- Секрет клиента OAuth из Google Cloud.
MCP_TOOL_GROUPS- Список групп инструментов: docs, drive, sheets, utils, gmail, calendar, script или all.
Ограничения
Нужен собственный клиент OAuth в Google Cloud: включить API Docs, Sheets, Drive, Gmail и Calendar, настроить экран согласия и получить Client ID и Secret. Токен сохраняется в ~/.config/google-docs-mcp/token.json. Комментарии, созданные программно, не всегда видны привязанными к тексту. API Apps Script нужно включить отдельно для каждого аккаунта на странице настроек. Изображения в markdown пока не поддерживаются. Лицензия MIT, последний коммит от 11 октября 2026 года. Gmail: sendEmail отправляет простой текст, trashMessage переносит письмо только в корзину, а getMessage отдает метаданные вложений без самих файлов. В Calendar updateEvent и deleteEvent меняют всю серию повторяющегося события, пока не указан id конкретного экземпляра.
Как отключить. Удалите блок google-docs из mcpServers и перезапустите клиент. Затем удалите файл ~/.config/google-docs-mcp/token.json и отзовите доступ в настройках аккаунта Google.
Частые вопросы
Как подключить Google Docs к Claude через MCP?
Создайте клиент OAuth типа Desktop в Google Cloud, включите нужные API, выполните npx -y @a-bonus/google-docs-mcp auth с GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET и добавьте сервер в конфигурацию клиента с командой npx и аргументами -y @a-bonus/google-docs-mcp.
Можно ли оставить только документы, без почты?
Да. Переменная MCP_TOOL_GROUPS принимает группы docs, drive, sheets, utils, gmail, calendar, script или all, так что регистрируйте только нужные.
Можно ли развернуть сервер для команды?
Да. Сервер запускается в Google Cloud Run или другом контейнерном хосте с MCP_TRANSPORT=httpStream, а каждый пользователь входит в Google через MCP OAuth 2.1 без локальной установки. Для токенов предусмотрено хранилище Firestore.
Что делать, если после обновления не работают Gmail и Calendar?
Удалите ~/.config/google-docs-mcp/token.json и пройдите авторизацию заново: области Gmail и Calendar добавлялись в поздних версиях, и старый токен их не содержит.
Где хранится токен доступа к Google?
В локальном режиме токен обновления лежит в файле ~/.config/google-docs-mcp/token.json. В удаленном развертывании токены хранятся в памяти или в Firestore, если задать TOKEN_STORE=firestore.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОдин MCP-сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Контактов, Chat и Apps Script с OAuth 2.1
GSuite MCP
mcp-gsuite
MCP-сервер для Gmail и Google Календаря на Python: поиск и чтение писем, черновики и ответы, события с участниками, несколько аккаунтов сразу
Google Calendar MCP Server — календарь для Claude
Google Calendar MCP Server
MCP календарь для Claude Desktop: агент смотрит, создает, переносит и удаляет события Google Calendar, включая повторяющиеся, по запросу на обычном языке
MCP-сервер для доступа агента к почте, календарю, файлам OneDrive и потокам Power Automate через Microsoft Graph
MCP-сервер Яндекс Календаря
Яндекс Календарь MCP для Claude
MCP-сервер для Яндекс Календаря: просмотр, создание и удаление событий через пароль приложения
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar (эта запись) | нет | OAuth | 678 | |
| Google Workspace MCP Server | нет | OAuth | 3 432 | один сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Chat и Apps Script |
| Google Workspace для Gemini CLI | нет | 648 | расширение именно для Gemini CLI, а не для общих клиентов MCP | |
| GSuite MCP | нет | OAuth | 491 | MCP-сервер для Gmail и Google Календаря на Python |
Коротко о README
README ведет через быстрый старт из трех шагов, затем описывает развертывание в Cloud Run, таблицы инструментов по сервисам и примеры запросов. Отдельные разделы посвящены переменным окружения, способам входа (OAuth и сервисный аккаунт), хранению токенов, работе с несколькими аккаунтами Google, известным ограничениям и диагностике.