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

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

Запуск

python server.py

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

Claude Desktop

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

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

Инструменты

Лицензия

MIT