Google Sheets MCP Server 是一个 Python 包，旨在通过模型上下文协议（MCP）实现 Google Sheets 的自动化。它提供了将 Google Sheets 与任何兼容 MCP 的客户端无缝集成的能力，使用户能够通过简单的安全 API 层完成电子表格的创建、读取、更新和删除等操作。
主要能力
- 对 Google Sheets 和表格提供完整的 CRUD 支持。
- 可与 Continue.dev、Claude Desktop、Perplexity 以及其他 MCP 客户端配合使用。
- 通过 Google 服务账号进行安全认证。
- 提供全面的 Google Sheets 自动化工具集。
- 支持通过 uvx 自动安装。
使用方式
- 环境要求：需要 uv 包管理器（用于 uvx 命令）、一个启用了服务账号的 Google Cloud 项目，以及一个兼容 MCP 的客户端（例如 Continue.dev）。
- 设置 Google 服务账号：
- 创建 Google Cloud 项目：在 Google Cloud Console 中点击“选择项目” → “新建项目”，输入项目名称（例如“my-sheets-automation”）。
- 启用所需 API：在项目中转到“API 和服务” → “库”，搜索“Google Sheets API”并启用，搜索“Google Drive API”并启用。
- 创建服务账号：转到“IAM 和管理” → “服务账号”，点击“创建服务账号”，输入服务账号名称（例如“sheets-mcp-service”），点击“创建并继续”，跳过角色分配，点击“继续”。
- 生成 JSON 密钥：点击新创建的服务账号邮箱，转到“密钥”选项卡 → “添加密钥” → “创建新密钥”，选择“JSON”格式，点击“创建”，JSON 文件将自动下载。
- 提取所需值：打开下载的 JSON 文件，记录以下值：project_id、private_key_id、private_key、client_email、client_id、client_x509_cert_url。
- 配置 MCP 客户端：可以直接从 Google 服务账号 JSON 文件中复制值，字段名称与 JSON 文件中的完全一致，无需更改。服务器还支持旧的 GOOGLE_ 前缀变量名（例如 GOOGLE_PROJECT_ID）以保持向后兼容。
- 将 Google 表格共享给服务账号：在浏览器中打开目标 Google 表格，点击“共享”按钮，输入服务账号邮箱（例如 your-service@your-project.iam.gserviceaccount.com），分配“编辑者”权限，点击“发送”以授予编辑权限。 完成上述步骤后，MCP 客户端将在需要时自动安装并运行该包。
适用场景 适用于需要通过 MCP 客户端自动化操作 Google Sheets 的场景，例如在 Continue.dev、Claude Desktop、Perplexity 等工具中实现电子表格的创建、读取、更新和删除。
限制
- 需要用户自行准备 Google Cloud 项目和服务账号，并完成 API 启用和权限配置。
- 需要将目标 Google 表格共享给服务账号邮箱并授予编辑权限。
- 需要安装 uv 包管理器以使用 uvx 命令。
- 该项目采用 MIT 许可证，具体细节请参阅 LICENSE 文件。
支持与贡献 如有问题可在 GitHub Issues 中报告，疑问可通过 LinkedIn 联系作者，欢迎提交拉取请求。
