mcp-google-sheets
MCP сервер для Google Sheets и Google Drive: агент читает, меняет и создает таблицы, листы и диаграммы
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Пишет и меняет данные в ваших таблицах Google Sheets и Google Drive
- Может выдавать доступ к таблицам другим пользователям по email
- Работает с ключами сервисного аккаунта или OAuth
Установка
Ручная установка
uvx mcp-google-sheets@latestПеред запуском задайте переменные SERVICE_ACCOUNT_PATH и DRIVE_FOLDER_ID. Нужен установленный uv.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает MCP-клиент с API Google Sheets и Google Drive. Агент находит таблицы в папке Drive, читает диапазоны в нотации A1, пишет и обновляет ячейки пакетно, добавляет строки и столбцы, создает листы и целые таблицы. Есть чтение формул, копирование и переименование листов, построение диаграмм и выдача доступа по email. Чтобы не тратить контекст, можно включить только нужные инструменты через ENABLED_TOOLS или флаг include-tools.
Для кого. Для аналитиков, маркетологов и владельцев бизнеса, кто ведет учет и отчеты в Google Sheets.
Подходит, если
- Нужно, чтобы агент читал и обновлял данные в Google Sheets
- Нужно собрать отчет или сводку по нескольким таблицам
- Нужно создать таблицу, лист или диаграмму без ручной работы
Не подходит, если
- Нет проекта в Google Cloud и сервисного аккаунта или OAuth
- Нужна работа с локальными файлами Excel, а не с облаком Google
Пример запроса к агенту
Собери из таблицы продаж за квартал сводку по менеджерам и запиши ее на новый листОграничения
Требует проект в Google Cloud с включенными Google Sheets API и Google Drive API и одним из способов аутентификации: сервисный аккаунт, OAuth или base64-ключ. Для сервисного аккаунта папку Drive нужно расшарить на его email. Сервер работает с облачными таблицами Google, локальные файлы Excel он не открывает.
Как отключить. Удалите блок mcp-google-sheets из конфигурации MCP-клиента и перезапустите его. Отдельная установка не требуется, так как uvx запускает пакет по запросу.
MCP
- Транспорт
- stdio, sse
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| SERVICE_ACCOUNT_PATH секрет | Путь к JSON-ключу сервисного аккаунта Google Cloud |
| DRIVE_FOLDER_ID | Id папки Google Drive, расшаренной на сервисный аккаунт |
| CREDENTIALS_PATH секрет | Путь к файлу OAuth-клиента при входе через браузер |
| CREDENTIALS_CONFIG секрет | Содержимое ключа в base64 вместо файла на диске |
Проверка безопасности
- Пишет и меняет данные в ваших таблицах Google Sheets и Google Drive
- Может выдавать доступ к таблицам другим пользователям по email
- Работает с ключами сервисного аккаунта или OAuth
Коротко о README
README описывает запуск через uvx одной командой, четыре способа аутентификации в Google Cloud и подробную настройку сервисного аккаунта и OAuth. Перечислены все инструменты для чтения, записи, пакетного обновления, работы с листами, диаграммами и выдачей доступа. Показаны конфигурации для Claude Desktop и запуск в Docker с транспортом SSE. Отдельно описано фильтрование инструментов для экономии контекста. Лицензия MIT.
Частые вопросы
Какой способ аутентификации выбрать?
Для автоматизации на сервере рекомендуется сервисный аккаунт: он работает без браузера. Для личного использования подойдет OAuth с входом в браузере при первом запуске.
Как уменьшить расход контекста?
По умолчанию включены все инструменты. Через переменную ENABLED_TOOLS или флаг include-tools можно оставить только нужные, например чтение и запись данных.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики