xing5/mcp-google-sheets

MCP-Google-Sheets

Портал вашего AI-ассистента к Google Sheets! 📊

---

🤔 Что это?

mcp-google-sheets — это MCP-сервер на основе Python, который служит мостом между любым совместимым с MCP клиентом (например, Claude Desktop) и API Google Sheets. Он позволяет взаимодействовать с вашими Google Spreadsheets с помощью определённого набора инструментов, обеспечивая мощную автоматизацию и работу с данными, управляемые ИИ.

---

🚀 Быстрый старт (с использованием uvx)

По сути, сервер работает в одной строке: uvx mcp-google-sheets@latest.

Эта команда автоматически скачает последний код и запустит его. Мы рекомендуем всегда использовать @latest, чтобы убедиться, что у вас самая новая версия с последними функциями и исправлениями ошибок.

Refer справочник по ID для получения дополнительной информации о используемых below.

1. ** ☁️ Предварительное условие: Google Cloud Setup**

• Вам нужно настроить учетные данные Google Cloud Platform и сначала включить необходимые API. Мы настоятельно рекомендуем использовать аккаунт сервиса. ➡️ * Перейдите к Подробному руководству по настройке Google Cloud Platform ниже.

2. ** 🐍 Установка uv**

• uvx является частью uv, быстрого установщика и резолвера пакетов на Python.

---

🤔 What is this?

mcp-google-sheets is a Python-based MCP server that acts as a bridge between any MCP-compatible client (like Claude Desktop) and the Google Sheets API. It allows you to interact with your Google Spreadsheets using a defined set of tools, enabling powerful automation and data manipulation workflows driven by AI.

---

🚀 Quick Start (Using uvx)

Essentially the server runs in one line: uvx mcp-google-sheets@latest.

This command will automatically download the latest code and run it. We recommend always using @latest to ensure you have the newest version with the latest features and bug fixes.

Refer to the ID Reference Guide for more information about the IDs used below.

1. ☁️ Prerequisite: Google Cloud Setup

   • You must configure Google Cloud Platform credentials and enable the necessary APIs first. We strongly recommend using a Service Account.
   • ➡️ Jump to the Detailed Google Cloud Platform Setup guide below.

2. 🐍 Install uv

   • uvx is part of uv, a fast Python package installer and resolver. Install it if you haven’t already:

     # macOS / Linux
     curl -LsSf https://astral.sh/uv/install.sh | sh
     # Windows
     powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
     # Or using pip:
     # pip install uv
     

     Follow instructions in the installer output to add uv to your PATH if needed.

3. 🔑 Set Essential Environment Variables (Service Account Recommended)

   • You need to tell the server how to authenticate. Set these variables in your terminal:
   • (Linux/macOS)

     # Replace with YOUR actual path and folder ID from the Google Setup step
     export SERVICE_ACCOUNT_PATH="/path/to/your/service-account-key.json"
     export DRIVE_FOLDER_ID="YOUR_DRIVE_FOLDER_ID"
     

   • (Windows CMD)

     set SERVICE_ACCOUNT_PATH="C:\path\to\your\service-account-key.json"
     set DRIVE_FOLDER_ID="YOUR_DRIVE_FOLDER_ID"
     

   • (Windows PowerShell)

     $env:SERVICE_ACCOUNT_PATH = "C:\path\to\your\service-account-key.json"
     $env:DRIVE_FOLDER_ID = "YOUR_DRIVE_FOLDER_ID"