Google Sheets MCP Server для Claude Code

Этот MCP сервер позволяет Claude читать и писать данные в твои Google Sheets напрямую, без необходимости выгружать таблицы вручную.

Что это дает для GAS разработки?

• 📊 Claude видит результаты скрипта — читает данные из таблиц в реальном времени

• ✅ Быстрая отладка — не нужно выгружать таблицу каждый раз

• 🚀 Автоматизация — Claude может писать результаты обратно в таблицу

• 📈 Мониторинг — читай логи выполнения скриптов прямо из Claude

Функциональность

Инструменты (Tools)

1. read_sheet - чтение данных из диапазона

   Прочитай данные из таблицы A1:D10 в моей таблице

2. write_sheet - запись данных в диапазон

   Напиши результаты в ячейки A1:C5 моей таблицы

3. append_sheet - добавление данных в конец

   Добавь новую строку в конец таблицы

4. get_metadata - получение информации о таблице

   Какие листы есть в моей таблице?

5. clear_sheet - очистка диапазона

   Очисти ячейки A1:D10

Быстрая установка

1. Подготовка Google Cloud

Смотри подробно в файле SETUP.md:

# В общих словах:
1. Создай проект в Google Cloud Console
2. Включи Google Sheets API
3. Создай Service Account
4. Скачай JSON ключ → переименуй в credentials.json
5. Положи credentials.json в папку проекта
6. Дай доступ к твоим таблицам сервис-аккаунту

2. Регистрация в Claude Code

После создания credentials.json:

cd D:\google-sheets-mcp

# Зарегистрируй сервер
claude mcp add --transport stdio google-sheets-mcp --env GOOGLE_CREDENTIALS_PATH="D:/google-sheets-mcp/credentials.json" -- node "D:/google-sheets-mcp/index.js"

3. Готово!

Теперь используй в Claude:

Прочитай данные из моей Google Sheets таблицы (ID: 1A2B3C4D5E...) диапазон A1:D10

Структура проекта

google-sheets-mcp/
├── index.js              # Главный файл MCP сервера
├── package.json          # Зависимости Node.js
├── credentials.json      # Google API ключ (скачать!)
├── .env.example          # Пример переменных окружения
├── SETUP.md              # Подробное руководство установки
├── README.md             # Этот файл
└── node_modules/         # Зависимости (создается при npm install)

Как получить ID таблицы?

1. Открой свою Google Sheets таблицу

2. Посмотри URL:

   https://docs.google.com/spreadsheets/d/1A2B3C4D5E6F7G8H9I0J/edit
                                        ^^^^^^^^^^^^^^^^^^^
                                        Это ID таблицы

Примеры использования в Claude

Чтение данных

Прочитай данные с листа "Results" диапазон A1:C20 из таблицы 1A2B3C4D...

Запись результатов

Напиши следующие данные в мою таблицу:
- Лист: "Logs"
- Диапазон: A1
- Значения: [["Date", "Result"], ["2025-01-15", "Success"], ["2025-01-16", "Error"]]

Добавление логов

Добавь в конец листа "Logs" новую строку с датой и результатом выполнения

Решение проблем

"Credentials file not found"

• Проверь что credentials.json находится в папке D:\google-sheets-mcp\

• Убедись что путь в переменной GOOGLE_CREDENTIALS_PATH правильный

"Permission denied"

• Убедись что дал права доступа сервис-аккаунту на таблицу

• Проверь что это service account email, а не твой личный

Сервер не стартует

• Проверь что установлены зависимости: npm install

• Убедись что Node.js установлен: node --version

Технические детали

• Язык: Node.js (JavaScript)

• MCP SDK версия: 1.20.1+

• Google API: Sheets API v4

• Аутентификация: Service Account (OAuth2)

• Транспорт: stdio (стандартный ввод-вывод)

Лимиты и ограничения

• Google API имеет rate limit (300 requests в минуту для читаемых операций)

• Максимальный размер одной ячейки: 50,000 символов

• Максимум 10,000,000 ячеек в одной таблице

Дальнейшее развитие

Можно расширить сервер на:

• Работу с Google Docs

• Работу с Google Forms

• Создание новых таблиц

• Форматирование ячеек (цвета, шрифты)

• Создание чартов и графиков

Вопросы?

Если что-то не работает:

1. Прочитай SETUP.md еще раз

2. Проверь логи ошибок в консоли

3. Убедись что credentials.json валидный JSON

Авторство: Создано для использования с Claude Code и Google Apps Script проектами