xing5/mcp-google-sheets

MCP-구글-시트

당신의 AI 비서가 구글 시트로 가는 관문! 📊

---

🤔 이게 뭐야?

mcp-google-sheets는 Python 기반 MCP 서버로, Claude Desktop과 같은 MCP 호환 클라이언트와 Google Sheets API 간의 다리 역할을 합니다. 정의된 도구 세트를 사용해 Google 스프레드시트와 상호작용할 수 있어, AI가 주도하는 강력한 자동화 및 데이터 처리 워크플로우를 가능하게 합니다.

---

🚀 퀵 스타트 (uvx 사용)

본질적으로 서버는 한 줄로 실행됩니다: uvx mcp-google-sheets@latest.

이 명령어는 최신 코드를 자동으로 다운로드하고 실행합니다. **항상 @latest**를 사용하여 최신 기능과 버그 수정이 포함된 최신 버전을 사용할 것을 권장합니다.

사용된 신분증에 대한 자세한 정보는 ID 참조 가이드를 Refer below.

1. ** ☁️ 전제 조건: Google Cloud Setup**

• 먼저 Google Cloud Platform 자격 증명을 설정하고 필요한 API를 활성화해야 합니다. Service Account 사용을 강력히 권장합니다. ➡️ * 아래 상세 구글 클라우드 플랫폼 설정 가이드로 이동하세요.

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"