xing5/mcp-google-sheets

MCP-Google-Sheets

あなたのAIアシスタントのGoogle Sheetsへのゲートウェイ!📊

---

🤔 これは何だ?

mcp-google-sheetsはPythonベースのMCPサーバーで、Claude DesktopのようなMCP互換クライアントとGoogle Sheets APIの間の橋渡し役を務めます。定義されたツールセットを使ってGoogleスプレッドシートとやり取りでき、AIによる強力な自動化およびデータ操作ワークフローを可能にします。

---

🚀 クイックスタート(uvxを使用)

基本的にサーバーは一列で動作します:uvx mcp-google-sheets@latest。

このコマンドは最新のコードを自動的にダウンロードし実行します。**@latest**を必ず使用し、最新の機能やバグ修正が入ったバージョンを確実に利用することを推奨します。

使用されたIDの詳細については、IDリファレンスガイド_Refer below._

1. ** ☁️ 前提条件:Google Cloud Setup**

• まず**Google Cloud Platformの認証情報を設定し、必要なAPIを有効にしてください。サービスアカウントの利用を強くお勧めします。
• ➡️ 以下に詳細なGoogle Cloudプラットフォーム設定ガイドへジャンプしてください。

2. ** 🐍 インストール uv**

• uvxは高速Pythonパッケージのインストーラー兼リゾルバであるuvの一部です。

---

🤔 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"