mcp-google-sheets
MCP сервер для Google Sheets и Google Drive: агент читает, меняет и создает таблицы, листы и диаграммы
- 1 018 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Пишет и меняет данные в ваших таблицах Google Sheets и Google Drive
- Может выдавать доступ к таблицам другим пользователям по email
- Работает с ключами сервисного аккаунта или OAuth
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-google-sheetsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Пишет и меняет данные в ваших таблицах Google Sheets и Google Drive
- Может выдавать доступ к таблицам другим пользователям по email
- Работает с ключами сервисного аккаунта или OAuth
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает MCP-клиент с API Google Sheets и Google Drive. Агент находит таблицы в папке Drive, читает диапазоны в нотации A1, пишет и обновляет ячейки пакетно, добавляет строки и столбцы, создает листы и целые таблицы. Есть чтение формул, копирование и переименование листов, построение диаграмм и выдача доступа по email. Чтобы не тратить контекст, можно включить только нужные инструменты через ENABLED_TOOLS или флаг include-tools.
Для кого. Для аналитиков, маркетологов и владельцев бизнеса, кто ведет учет и отчеты в Google Sheets.
Подходит, если
- Нужно, чтобы агент читал и обновлял данные в Google Sheets
- Нужно собрать отчет или сводку по нескольким таблицам
- Нужно создать таблицу, лист или диаграмму без ручной работы
Не подходит, если
- Нет проекта в Google Cloud и сервисного аккаунта или OAuth
- Нужна работа с локальными файлами Excel, а не с облаком Google
Пример запроса к агенту
Собери из таблицы продаж за квартал сводку по менеджерам и запиши ее на новый листMCP
- Транспорт
- stdio, sse
- Авторизация
- OAuth
Переменные окружения
SERVICE_ACCOUNT_PATHсекрет- Путь к JSON-ключу сервисного аккаунта Google Cloud
DRIVE_FOLDER_ID- Id папки Google Drive, расшаренной на сервисный аккаунт
CREDENTIALS_PATHсекрет- Путь к файлу OAuth-клиента при входе через браузер
CREDENTIALS_CONFIGсекрет- Содержимое ключа в base64 вместо файла на диске
Ограничения
Требует проект в Google Cloud с включенными Google Sheets API и Google Drive API и одним из способов аутентификации: сервисный аккаунт, OAuth или base64-ключ. Для сервисного аккаунта папку Drive нужно расшарить на его email. Сервер работает с облачными таблицами Google, локальные файлы Excel он не открывает.
Как отключить. Удалите блок mcp-google-sheets из конфигурации MCP-клиента и перезапустите его. Отдельная установка не требуется, так как uvx запускает пакет по запросу.
Частые вопросы
Какой способ аутентификации выбрать?
Для автоматизации на сервере рекомендуется сервисный аккаунт: он работает без браузера. Для личного использования подойдет OAuth с входом в браузере при первом запуске.
Как уменьшить расход контекста?
По умолчанию включены все инструменты. Через переменную ENABLED_TOOLS или флаг include-tools можно оставить только нужные, например чтение и запись данных.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI для управления настоящим Microsoft Excel: Power Query, DAX, VBA, сводные таблицы, диаграммы
MCP-сервер для доступа агента к MySQL: чтение схемы и запросы, по умолчанию только на чтение, запись включается флагами
MCP-сервер на Python для работы с MySQL: список таблиц, чтение данных, выполнение SQL и разбор схемы через контролируемый интерфейс
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
MCP-сервер для Airtable: агент изучает схему баз, ищет, создает, обновляет и удаляет записи, работает с полями и комментариями
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Из блога
Коротко о README
README описывает запуск через uvx одной командой, четыре способа аутентификации в Google Cloud и подробную настройку сервисного аккаунта и OAuth. Перечислены все инструменты для чтения, записи, пакетного обновления, работы с листами, диаграммами и выдачей доступа. Показаны конфигурации для Claude Desktop и запуск в Docker с транспортом SSE. Отдельно описано фильтрование инструментов для экономии контекста. Лицензия MIT.