Google Sheets MCP

🚀 Google Sheets MCP Server

Google Sheets MCP Server 是一款強大的工具，它藉助模型上下文協議（MCP）實現 Google Sheets 的自動化操作，能讓 Google Sheets 與任何支持 MCP 的客戶端無縫集成。

🚀 快速開始

1. 設置 Google 服務賬戶

步驟 1：創建 Google Cloud 項目

1. 訪問 Google Cloud 控制檯。
2. 點擊“選擇項目”→“新建項目”。
3. 輸入項目名稱（例如：“my - sheets - automation”）。
4. 點擊“創建”。

步驟 2：啟用所需的 API

1. 在項目中，轉到“API 和服務”→“庫”。
2. 搜索“Google Sheets API”→ 點擊 →“啟用”。
3. 搜索“Google Drive API”→ 點擊 →“啟用”。

步驟 3：創建服務賬戶

1. 轉到“IAM 和管理”→“服務賬戶”。
2. 點擊“創建服務賬戶”。
3. 輸入服務賬戶名稱（例如：“sheets - mcp - service”）。
4. 點擊“創建並繼續”。
5. 跳過角色分配 → 點擊“繼續”。
6. 點擊“完成”。

步驟 4：生成 JSON 密鑰

1. 點擊新創建的服務賬戶電子郵件。
2. 轉到“密鑰”標籤頁 →“添加密鑰”→“創建新密鑰”。
3. 選擇“JSON”格式 → 點擊“創建”。
4. JSON 文件將自動下載。

步驟 5：提取所需的值

打開下載的 JSON 文件，並記錄以下值：

• project_id（例如：“my - sheets - automation - 123456”）
• private_key（以“-----BEGIN PRIVATE KEY-----”開頭的長私鑰）
• client_email（例如：“sheets - mcp - service@my - sheets - automation - 123456.iam.gserviceaccount.com”）

如有需要，請遵循此指南

2. 配置 MCP 客戶端

{
  "mcpServers": {
    "google - sheets - mcp": {
      "command": "uvx",
      "args": ["google - sheets - mcp@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your - project - id",
        "GOOGLE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "GOOGLE_CLIENT_EMAIL": "your - service@your - project.iam.gserviceaccount.com"
      }
    }
  }
}

從 Google 服務賬戶的 JSON 文件中提取以下值：

• project_id → GOOGLE_PROJECT_ID
• private_key → GOOGLE_PRIVATE_KEY
• client_email → GOOGLE_CLIENT_EMAIL

3. 與服務賬戶共享 Google 表格

• 在瀏覽器中打開目標 Google 電子表格。
• 點擊“共享”按鈕。
• 輸入服務賬戶電子郵件（例如：your - service@your - project.iam.gserviceaccount.com），並分配編輯權限。
• 點擊“發送”以授予編輯權限。

🎉 大功告成！ 您的 MCP 客戶端將在需要時自動安裝並運行該軟件包。

✨ 主要特性

• 對 Google 表格和數據表提供完整的 CRUD 操作支持。
• 可與 Continue.dev、Claude Desktop、Perplexity 等其他 MCP 客戶端配合使用。
• 通過 Google 服務賬戶進行安全認證。
• 提供用於 Google 表格自動化的綜合工具。
• 可通過 uvx 自動安裝。

📦 安裝指南

要求

• Python 3.10 及以上版本
• uv 包管理器（用於 uvx 命令）
• 帶有服務賬戶的 Google Cloud 項目
• 支持 MCP 的客戶端（例如：Continue.dev）

安裝 uv：

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

📄 許可證

本項目採用 MIT 許可證，請參閱 LICENSE 文件以獲取詳細信息。

👨‍💻 作者

Henil C Alagiya

• GitHub: @henilcalagiya
• LinkedIn: Henil C Alagiya

支持與貢獻：

• 🐛 報告問題：[GitHub 問題](https://github.com/henilcalagiya/google - sheets - mcp/issues)
• 💬 提問：在 LinkedIn 上聯繫作者
• 🤝 貢獻代碼：歡迎提交拉取請求！