Google Sheets MCP 服务器
使用模型上下文协议（MCP）实现Google Sheets自动化处理的强大工具
mcp名称：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+（或“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云项目
- 首选 Google Cloud 控制台
- 点击“选择项目”→“新建项目”
- 输入项目名称（例如：“my-sheets-automation”）
- 点击“创建”
步骤2：启用所需API
- 在你的项目中，进入“APIs和服务”→“库”
- 搜索“Google Sheets API”→点击→“启用”
- 搜索“Google Drive API”→点击→“启用”
步骤3：创建服务账户
- 前往“IAM & 管理”→“服务帐号”
- 点击“创建服务帐户”
- 输入服务帐户名称（例如，“sheets-mcp-service”）
- 点击“创建并继续”
- 跳过角色分配 → 点击“继续”
- 点击“完成”
步骤4：生成JSON密钥
- 点击您的新服务账户电子邮件
- 转到“密钥”选项卡 → “添加密钥” → “创建新密钥”
- 选择“JSON”格式 → 点击“创建”
- 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": "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许可证授权——详见 许可证 详情请查阅文件。
作者
Henil C Alagiya（人名，根据音译可译为“亨尼尔·C·阿拉吉亚”，但具体译名可能因个人习惯或官方翻译而异）
- GitHub: @henilcalagiya（注：这是一个社交媒体用户名，直接翻译为中文仍为原样，因为用户名通常不翻译，保持原样以识别特定用户）
- LinkedIn（领英）: Henil C Alagiya（这个名字在中文中没有直接对应的翻译，通常人名在翻译时会保持原样或根据发音进行音译，但在此处由于其独特性，我们直接保留原名）
支持与贡献：
- 🐛 蚜虫 报告问题:
- 💬（这个表情符号在中文中通常没有直接对应的翻译，它表示“文字/对话”的意思，可以理解为“说”或“聊天”的概念。） 问题联系我 LinkedIn（领英）
- 🤝（握手） 贡献欢迎提交拉取请求！