google-sheets-mcp

Google Sheets MCP 服务

使用 Model Context Protocol（MCP）自动化 Google Sheets 的强大工具

mcp-name: io.github.henilcalagiya/google-sheets-mcp

概述

Google Sheets MCP 服务可将 Google Sheets 与任何兼容 MCP 的客户端无缝集成。它通过简单、安全的 API 层实现完整的电子表格自动化，包括创建、读取、更新和删除工作表。

功能

• 全面支持 Google Sheets 和表格的 CRUD 操作
• 兼容 Continue.dev、Claude Desktop、Perplexity 和其他 MCP 客户端
• 通过 Google 服务账号安全进行身份验证
• 提供用于自动化 Google Sheets 的全面工具
• 通过 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

---

快速开始

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_id（例如，“a4ae73111b11b2c3b07cc01006e71eb8230dfa29”）
• private_key（以“-----BEGIN PRIVATE KEY-----”开头的长私钥）
• client_email（例如，“sheets-mcp-service@my-sheets-automation-123456.iam.gserviceaccount.com”）
• client_id（例如，“113227823918217958816”）
• client_x509_cert_url（例如，“https://www.googleapis.com/robot/v1/metadata/x509/sheets-mcp-service%40my-sheets-automation-123456.iam.gserviceaccount.com”）

Google 服务账号 JSON 结构示例：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "[email protected]",
  "client_id": "your-client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service%40your-project.iam.gserviceaccount.com"
}

如有需要，请参阅此指南

2. 配置 MCP 客户端

{
  "mcpServers": {
    "google-sheets-mcp": {
      "command": "uvx",
      "args": ["google-sheets-mcp@latest"],
      "env": {
        "project_id": "your-project-id",
        "private_key_id": "your-private-key-id",
        "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "client_email": "[email protected]",
        "client_id": "your-client-id",
        "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service%40your-project.iam.gserviceaccount.com"
      }
    }
  }
}

💡 专业提示： 你可以直接从 Google 服务账号 JSON 文件中复制这些值。JSON 文件中的字段名称可直接使用，无需更改！

🔄 向后兼容性： 服务也支持旧版带 GOOGLE_ 前缀的变量名称（例如，GOOGLE_PROJECT_ID），以兼容现有配置。

3. 与服务账号共享 Google 表格

• 在浏览器中打开目标 Google 电子表格。
• 点击共享按钮。
• 输入服务账号邮箱地址（例如，[email protected]），并授予编辑者权限。
• 点击发送以授予编辑权限。

🎉 一切就绪！ MCP 客户端会在需要时自动安装并运行此软件包。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

作者

Henil C Alagiya

• GitHub： @henilcalagiya
• LinkedIn：Henil C Alagiya

支持与贡献：

• 🐛 报告问题：GitHub Issues
• 💬 提出问题：通过 LinkedIn 联系
• 🤝 贡献代码：欢迎提交拉取请求！