mcp-gsheets
mcp-gsheets читает и правит таблицы Google Sheets через сервисный аккаунт: значения, форматирование, диаграммы и нативные таблицы.
- 105 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер может удалять строки, столбцы и листы в таблицах, открытых сервисному аккаунту.
- Ключ сервисного аккаунта хранится в конфигурации клиента.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-gsheetsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер может удалять строки, столбцы и листы в таблицах, открытых сервисному аккаунту.
- Ключ сервисного аккаунта хранится в конфигурации клиента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-gsheets, MCP-сервер, подключает клиент к Google Sheets API. Инструменты читают значения диапазонов, пишут и дописывают строки, создают и удаляют листы, форматируют ячейки, ставят условное форматирование, строят диаграммы и управляют нативными таблицами. Доступ идет через сервисный аккаунт Google Cloud: ключ задают файлом, строкой JSON либо парой приватного ключа и почты. Чтобы не раздувать контекст, набор инструментов можно сократить настройкой toolsets. Для Claude Code в репозитории есть плагин, сервер публикуется в реестре MCP.
Для кого. Разработчикам и аналитикам, которые ведут отчеты и учет в Google Таблицах и хотят поручать правки агенту.
Подходит, если
- Агент заполняет таблицу результатами парсинга по строкам.
- Нужно привести форматирование нескольких листов к единому виду.
- По данным диапазона надо построить диаграмму прямо в файле.
- Данные из одной таблицы копируют в другую без ручных операций.
Не подходит, если
- Нет возможности создать проект Google Cloud и сервисный аккаунт.
- Таблицу нельзя открывать для почты сервисного аккаунта.
- Нужна работа от имени личной учетной записи с OAuth-входом.
Пример запроса к агенту
Допиши в таблицу отчета строки с итогами недели через INSERT_ROWS, затем отформатируй заголовок и построй столбчатую диаграмму.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
GOOGLE_PROJECT_IDобязательная- Идентификатор проекта Google Cloud
GOOGLE_APPLICATION_CREDENTIALSобязательная, секрет- Путь к JSON-ключу сервисного аккаунта
Ограничения
Нужны Node.js 22 или новее, проект Google Cloud с включенным Sheets API и сервисный аккаунт с JSON-ключом. Таблицу надо предоставить почте сервисного аккаунта. Есть деструктивные инструменты: удаление строк, столбцов и листов. У `sheets_append_values` значение `insertDataOption` по умолчанию `OVERWRITE`, указывайте `INSERT_ROWS`. Ключ аккаунта хранится в конфигурации клиента. Сервер не создает резервных копий таблиц, поэтому перед массовой правкой сделайте копию файла в Google Таблицах.
Как отключить. Выполните `claude mcp remove mcp-gsheets` либо уберите запись из конфигурации клиента. Отзовите доступ сервисного аккаунта в таблицах и удалите его ключ в консоли Google Cloud.
Частые вопросы
Как дать серверу доступ к таблице?
Откройте таблицу, нажмите Share и добавьте почту сервисного аккаунта из JSON-ключа. Проверьте результат инструментом `sheets_check_access`.
Какими способами задают ключ?
Файл через `GOOGLE_APPLICATION_CREDENTIALS`, строка JSON в `GOOGLE_SERVICE_ACCOUNT_KEY` либо пара `GOOGLE_PRIVATE_KEY` и `GOOGLE_CLIENT_EMAIL`.
Как уменьшить число инструментов?
Раздел toolsets в Документ описывает сокращение набора, чтобы описания инструментов занимали меньше контекста.
Почему строки перезаписались при дописывании?
По умолчанию `insertDataOption` равен `OVERWRITE`. Для вставки со сдвигом передайте `INSERT_ROWS`.
Нужен ли OAuth-вход?
Нет. Сервер работает через сервисный аккаунт Google Cloud, личный вход пользователя не используется.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыGoogle Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
Один MCP-сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Контактов, Chat и Apps Script с OAuth 2.1
GSuite MCP
mcp-gsuite
MCP-сервер для Gmail и Google Календаря на Python: поиск и чтение писем, черновики и ответы, события с участниками, несколько аккаунтов сразу
MCP-сервер для почты, календаря и файлов Google: агент работает с несколькими аккаунтами от вашего имени
Google Calendar MCP Server — календарь для Claude
Google Calendar MCP Server
MCP календарь для Claude Desktop: агент смотрит, создает, переносит и удаляет события Google Calendar, включая повторяющиеся, по запросу на обычном языке
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Коротко о README
Документ ведет от требований и быстрой установки к настройке Google Cloud, трем способам задать ключ и таблице из десятков инструментов, сгруппированных по чтению, записи, форматированию и диаграммам.