HgDeveloper13

kilocode-mcp-google-workspace

Community HgDeveloper13
Updated

Kilocode - MCP Google Workspace

-+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

MCP Server · Populars

MCP Server · New