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