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 上联系作者
• 🤝 贡献代码：欢迎提交拉取请求！