Google Workspace MCP Server

-+693# Google Sheets MCP Server

MCP (Model Context Protocol) сервер для взаимодействия с Google Sheets, Google Docs и Google Drive.

Возможности

Google Sheets

• Чтение данных из таблиц
• Обновление ячеек
• Пакетное обновление нескольких диапазонов
• Добавление строк и столбцов
• Создание, переименование, копирование и удаление листов
• Получение формул из ячелей
• Получение списка таблиц из Google Drive

Google Docs

• Чтение содержимого документов
• Извлечение текста из документов
• Вставка текста в документы
• Удаление текста из документов
• Создание документов (опционально)

Google Drive

• Поиск файлов
• Скачивание Google Docs как TXT
• Обновление содержимого файлов
• Предоставление доступа к таблицам

Установка

# Клонирование репозитория
git clone https://github.com/yourusername/mcp-google-sheets.git
cd mcp-google-sheets

# Создание виртуального окружения
python -m venv venv
source venv/bin/activate  # Linux/Mac
# или
venv\Scripts\activate  # Windows

# Установка зависимостей
pip install -r requirements.txt

Настройка аутентификации

Способ 1: Service Account (рекомендуется)

1. Создайте сервисный аккаунт в Google Cloud Console
2. Скачайте JSON-файл с ключом
3. Предоставьте сервисному аккаунту доступ к таблицам и диску

Укажите путь к файлу:

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

Способ 2: OAuth 2.0

1. Создайте OAuth credentials в Google Cloud Console
2. Скачайте credentials.json
3. При первом запуске будет предложено авторизоваться через браузер
4. Токен будет сохранён в token.json

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

Переменная	Описание	По умолчанию
GOOGLE_APPLICATION_CREDENTIALS	Путь к файлу сервисного аккаунта	service-account-key.json
CREDENTIALS_CONFIG	Base64-encoded JSON сервисного аккаунта	-
DRIVE_FOLDER_ID	ID папки в Google Drive для поиска таблиц	-
ENABLE_CREATE_TOOLS	Включить инструменты создания (true/false)	false

Запуск

python server.py

Использование с MCP-клиентами

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "google-sheets": {
      "command": "python",
      "args": ["/path/to/mcp-google-sheets/server.py"]
    }
  }
}

Инструменты

Инструмент	Описание
get_sheet_data	Получить данные из листа
get_sheet_formulas	Получить формулы из ячеек
update_cells	Обновить значения ячеек
batch_update_cells	Пакетное обновление нескольких диапазонов
add_rows	Добавить строки
add_columns	Добавить столбцы
list_sheets	Получить список листов
copy_sheet	Копировать лист
rename_sheet	Переименовать лист
delete_sheet	Удалить лист
list_spreadsheets	Получить список таблиц
share_spreadsheet	Предоставить доступ к таблице
get_doc_content	Получить содержимое документа
get_doc_text	Получить текст документа
search_drive_files	Поиск файлов в Drive

Лицензия

MIT