Google Sheets MCP

TypeScript MCP сервер, который позволяет ИИ агентам безопасно взаимодействовать с Google Sheets через типизированные инструменты, поддерживая аутентификацию как через OAuth2, так и через Service Account.

Установка

Из исходного кода

git clone https://github.com/yourusername/mcp-google-sheets.git
cd mcp-google-sheets
bun install

Доступные инструменты

Инструмент	Описание
`create`	Создает новую таблицу (и перемещает ее в вашу папку Drive, если настроена)
`listSheets`	Выводит список всех вкладок листов в данной таблице
`renameSheet`	Переименовывает существующую вкладку листа
`createSheet`	Добавляет новую вкладку листа в таблицу
`spreadsheetInfo`	Получает метаданные (название, ID листов, свойства сетки) для таблицы
`listSpreadsheets`	Выводит список всех таблиц в настроенной папке Drive (или в "Мой диск")
`shareSpreadsheet`	Делится таблицей с пользователями (читатель/комментатор/редактор) и отправляет уведомления
`sheetData`	Читает значения ячеек из листа и диапазона (или всего листа)
`updateCells`	Записывает двумерный массив значений в диапазон формата A1
`batchUpdate`	Применяет несколько обновлений диапазонов в одном запросе
`addRows`	Вставляет строки по указанному индексу
`addColumns`	Вставляет столбцы по указанному индексу
`copySheet`	Копирует вкладку листа между таблицами (с возможностью переименования)

Возможности

Аутентификация через Service Account с использованием CREDENTIALS_CONFIG в формате base64
OAuth2 аутентификация через credentials.json + token.json для доступа в рамках пользователя
Создание, чтение, обновление и управление Google Sheets и таблицами
Совместное использование таблиц с различными уровнями разрешений
Пакетные операции для эффективного обновления данных
Интеграция с Google Drive для организации файлов

Переменные окружения

Обязательные

EMAIL_ID - Адрес электронной почты Google, который вы будете использовать для доступа к таблице

Опциональные

CREDENTIALS_CONFIG - JSON ключ service account в кодировке base64
DRIVE_FOLDER_ID - ID папки Drive для сохранения новых таблиц

Ресурсы

GitHub Repository

Примечания

Требует Bun v1.0+, проект Google Cloud с включенными Sheets API и Drive API, а также учетные данные OAuth2 Client ID или Service Account. Использует StdioServerTransport для интеграции с Claude. При первом запуске OAuth2 вам нужно будет перейти по URL и вставить код авторизации.

Installation

Description