Google Drive MCP
Свой MCP-сервер с 130 инструментами для офисного пакета Google: файлы, документы, таблицы, презентации и календарь
- 235 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает, правит и удаляет файлы в Drive, меняет доступ к ним и создает события календаря с вашими правами
- Токены OAuth лежат на диске и открывают Drive, Docs, Sheets, Slides и Calendar вашего аккаунта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/google-drive-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает, правит и удаляет файлы в Drive, меняет доступ к ним и создает события календаря с вашими правами
- Токены OAuth лежат на диске и открывают Drive, Docs, Sheets, Slides и Calendar вашего аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает MCP-клиент к Google Drive, Docs, Sheets, Slides и Calendar. Агент ищет и раскладывает файлы, создает и правит документы, форматирует таблицы, пишет презентации, управляет доступом к файлам и создает события календаря со ссылкой Google Meet. Всего 130 инструментов: файлы, общие диски, права, ревизии, богатая правка Docs, оформление Sheets, Slides и события Calendar. Дополнительно есть интерфейс ресурсов `gdrive:///` для прямого чтения. У сервера три режима: stdio для личного клиента, Streamable HTTP для размещенной интеграции и командный режим с OAuth 2.1 для общего сервиса. Локальный вход поддерживает несколько аккаунтов Google, и аккаунт можно выбирать в каждом вызове, возможны также сервисные аккаунты и внешне выданные токены. Учетные данные и токены остаются там, где вы запускаете сервер. Токены лежат по умолчанию в `~/.config/google-drive-mcp/tokens.json`.
Для кого. Тем, кто ведет отчеты, презентации и календарь в Google Workspace и хочет поручить рутину агенту на своих учетных данных.
Подходит, если
- Найти PDF из папки Reports, создать папку Archive и перенести в нее файлы старше года
- Собрать таблицу с месячными итогами, написать по ней сводку в Docs и сделать короткую презентацию
- В документе Project Plan заменить дату запуска, выделить ее жирным и оставить комментарий об изменении
- Создать событие в календаре со ссылкой Google Meet и приложить бриф из Drive
Не подходит, если
- Нужны другие продукты Google Workspace: сервер сосредоточен на Drive, Docs, Sheets, Slides и Calendar
- Нельзя дать агенту право менять и удалять файлы: инструменты включают запись, доступ и ревизии
- Нет проекта в Google Cloud: для входа нужны учетные данные OAuth типа Desktop
Пример запроса к агенту
Найди в Drive файлы, измененные за последние семь дней, и покажи список с владельцем и датой, ничего не меняяMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Ограничения
Для запуска нужны проект Google Cloud с включенными API Drive, Docs, Sheets, Slides и Calendar, экран согласия OAuth и клиент типа Desktop; файл ключей сохраняют как `~/.config/google-drive-mcp/gcp-oauth.keys.json`, затем выполняют `npx -y @piotr-agier/google-drive-mcp auth`. Пока приложение в режиме тестирования, свой аккаунт добавляют как тестового. В командном режиме нужны `--team`, режим HTTP и публичный HTTPS-адрес `--issuer-url`. Сервер намеренно не покрывает все API Workspace. Повторные попытки при ошибках 429, 503 и 504 включены, а по умолчанию их три.
Как отключить. Удалите блок google-drive из конфигурации клиента, удалите `~/.config/google-drive-mcp/tokens.json` и отзовите доступ приложения на странице безопасности аккаунта Google.
Частые вопросы
Как подключить Google Drive MCP?
Получите учетные данные OAuth в Google Cloud, выполните `npx -y @piotr-agier/google-drive-mcp auth`, затем добавьте в клиент сервер с командой `npx` и аргументами `-y`, `@piotr-agier/google-drive-mcp` и перезапустите клиент.
Как проверить, какой аккаунт активен?
Попросите агента выполнить `authGetStatus`: инструмент назовет активный аккаунт Google. При нескольких аккаунтах его можно выбирать в каждом вызове.
Какие режимы транспорта есть?
stdio для личного настольного клиента, Streamable HTTP для размещенной интеграции (порт 3100 по умолчанию) и командный режим `--team` с OAuth 2.1 для общего сервиса.
Где хранятся токены?
По умолчанию в `~/.config/google-drive-mcp/tokens.json` на машине, где запущен сервер. Учетные данные и токены не покидают среду, которую вы контролируете.
Можно ли ограничить ресурсы gdrive?
Да, флагом `--no-resources` отключают интерфейс `gdrive:///`, а инструменты остаются включенными.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыONLYOFFICE DocSpace MCP — комнаты и файлы в агенте
ONLYOFFICE Apps MCP Server
Официальный MCP-сервер ONLYOFFICE: агент управляет комнатами, папками, файлами и правами доступа в DocSpace по OAuth или ключу
Локальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки
MCP-сервер для создания и правки файлов Excel без установленного Microsoft Office: формулы, форматы, графики, сводные таблицы
Launchstack MCP обновляет сохраненный разговор по прежнему идентификатору, чтобы продолжение не создавало еще одну копию.
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
MCP-сервер открывает агенту чтение и поиск по локальным базам Molio, включая дерево файлов и вопросы по содержимому.
Коротко о README
Текст описывает сервер как единую точку подключения к Drive и редакторам Google с сохранением контроля над учетными данными. Дальше идут таблица совместимости клиентов, быстрый старт с созданием учетных данных OAuth, первые вызовы, примеры сценариев и список руководств по документам: аутентификация, конфигурация, развертывание, инструменты.