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).

Настройка клиентов

cursor
{
    "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.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники