mcp-gsheets
mcp-gsheets — MCP-сервер сообщества (автор — freema). Google Sheets: чтение, запись, форматирование и пакетные операции. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- freema
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- token_env
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Ключ сервисного аккаунта Google; запись, очистка и удаление данных и листов в таблицах, к которым открыт доступ (отключается GSHEETS_READ_ONLY=true).
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"mcp-gsheets\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-gsheets@latest\"],\n \"env\": {\n \"GOOGLE_PROJECT_ID\": \"your-project-id\",\n \"GOOGLE_APPLICATION_CREDENTIALS\": \"/absolute/path/to/service-account-key.json\"\n }\n }\n }\n}",
"lang": "json",
"notes": "Cursor Settings → MCP → New MCP Server",
"verified": "docs"
}
Что умеет
MCP Google Sheets Server — MCP-сервер для Google Sheets API: ассистент читает, записывает и оформляет таблицы, управляет листами, строит диаграммы и работает с нативными таблицами. Всего 44 инструмента, лицензия MIT. Нужен Node.js 22 или новее.
Чтение: sheets_get_values и sheets_batch_get_values (значения одного или нескольких диапазонов в нотации A1), sheets_get_metadata (название, локаль, список листов с ID), sheets_check_access (проверка доступа сервисного аккаунта).
Запись: sheets_update_values, sheets_batch_update_values, sheets_append_values, sheets_clear_values, sheets_insert_rows, sheets_delete_rows, sheets_delete_columns, sheets_insert_link и sheets_insert_date. У sheets_append_values по умолчанию insertDataOption равен OVERWRITE — чтобы сдвигать существующие строки вниз, укажите INSERT_ROWS.
Листы: создание файла sheets_create_spreadsheet, добавление, удаление, дублирование и копирование листов в другую таблицу, переименование и цвет вкладки.
Оформление: цвета, шрифты, выравнивание и формат чисел, границы, объединение ячеек, правила условного форматирования.
Нативные таблицы и диаграммы: sheets_add_table, sheets_update_table, sheets_delete_table, sheets_get_tables; sheets_create_chart, sheets_update_chart, sheets_delete_chart.
Снимки структуры: объединённые ячейки, размеры строк и столбцов, форматирование (в том числе компактное — сжимает вывод более чем на 90 %), условное форматирование, фильтры, проверка данных и sheets_get_full_sheet_snapshot — вся структура одним вызовом.
Наборы инструментов. Все 44 инструмента занимают около 9900 токенов контекста в каждой сессии. GSHEETS_TOOLSETS ограничивает набор: core (11 инструментов, всегда включён), sheets, formatting, charts, tables, analysis. Опечатка в названии — ошибка запуска. GSHEETS_READ_ONLY=true убирает все пишущие инструменты и проверяется при вызове, так что клиент не сможет писать, назвав скрытый инструмент. Инструменты помечены аннотациями readOnlyHint, destructiveHint и idempotentHint.
Кому подойдёт
- Аналитикам и менеджерам, которые ведут отчёты в Google Sheets.
- Разработчикам, автоматизирующим выгрузку данных в таблицы.
Похожие серверы — в категории данные и аналитика.
Установка
В Google Cloud Console создайте или выберите проект, включите Google Sheets API, создайте сервисный аккаунт и скачайте его JSON-ключ. Затем откройте нужную таблицу, нажмите «Поделиться» и выдайте адресу сервисного аккаунта права редактора. Вместо пути к файлу ключ можно передать JSON-строкой в GOOGLE_SERVICE_ACCOUNT_KEY или парой GOOGLE_PRIVATE_KEY и GOOGLE_CLIENT_EMAIL. Для локальной сборки есть интерактивный скрипт npm run setup.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add mcp-gsheets npx mcp-gsheets@latestПосле команды в Claude Code добавьте в конфиг переменные GOOGLE_PROJECT_ID и GOOGLE_APPLICATION_CREDENTIALS. Конфиг Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows, ~/.config/claude/claude_desktop_config.json в Linux. В Cursor: Cursor Settings → MCP → New MCP Server.
Проверка
Попросите проверить доступ к таблице по её ID — сработает sheets_check_access. ID берётся из URL между /d/ и /edit.
Примеры задач
Прочитай диапазон Лист1!A1:D20 и посчитай сумму по столбцу D.Добавь на лист «Продажи» столбчатую диаграмму по месяцам.Риски
- Ключ сервисного аккаунта. Храните JSON-ключ в надёжном месте и не публикуйте.
- Изменение и удаление данных. Сервер перезаписывает значения, удаляет строки, столбцы и листы. README советует сначала тестировать на копии данных; для чтения включите
GSHEETS_READ_ONLY=true. - Доступ ограничен таблицами, которыми вы поделились с сервисным аккаунтом.
Частые вопросы
Почему «Permission denied»?
Поделитесь таблицей с адресом сервисного аккаунта и выдайте права редактора.
Как уменьшить расход контекста?
Ограничьте инструменты через GSHEETS_TOOLSETS, например только core.
Можно ли запретить запись?
Да, GSHEETS_READ_ONLY=true оставляет только читающие инструменты.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
dbx
Запросы агентов к базам данных через подключения, настроенные в DBX.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.