Google Sheets MCP Server

使用模型上下文协议（MCP）实现Google Sheets自动化的强大工具

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

概述

Google Sheets MCP Server 提供了与任何兼容MCP客户端无缝集成Google Sheets的功能。它通过简单且安全的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-113456.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": "your-service@your-project.iam.gserviceaccount.com",
  "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": "your-service@your-project.iam.gserviceaccount.com",
        "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电子表格。
• 点击分享按钮。
• 输入服务账户电子邮件（例如，your-service@your-project.iam.gserviceaccount.com），并赋予编辑者权限。
• 点击发送以提供编辑权限。

🎉 您已设置完毕！ 当需要时，您的MCP客户端将自动安装并运行该包。

许可证

本项目采用MIT许可证——详情见LICENSE文件。

作者

Henil C Alagiya

• GitHub: @henilcalagiya
• LinkedIn: Henil C Alagiya

支持与贡献：

• 🐛 报告问题：GitHub Issues
• 💬 提问：在LinkedIn上联系我们
• 🤝 贡献：欢迎提交拉取请求！