Google Sheets MCP

基本能力

产品定位

Google Sheets MCP 是一个专门用于与 Google Sheets 交互的 MCP 连接器，旨在为 AI 代理提供直接操作电子表格的能力。

核心功能

• 数据读取：支持读取表格中的所有数据、特定行、列或标题。
• 数据编辑：支持编辑单个单元格、整行或整列数据。
• 表格管理：支持创建新的表格、重命名表格或工作表、插入行或列等。
• 认证管理：支持重新认证 Google 账户。

适用场景

• 自动化数据处理：AI 代理可以自动读取和更新 Google Sheets 中的数据。
• 协作工具集成：在团队协作中，AI 可以管理共享的电子表格。
• 开发效率提升：开发者可以通过 AI 代理快速操作表格数据，减少手动操作。

工具列表

• refresh_auth：重新认证 Google 账户。
• list_sheets：列出所有工作表。
• create_sheet：创建新的工作表。
• create_spreadsheet：创建新的电子表格。
• read_all_from_sheet：读取工作表中的所有数据。
• read_headings：读取列标题。
• read_rows：读取特定行。
• read_columns：读取特定列。
• edit_cell：编辑单个单元格。
• edit_row：编辑整行。
• edit_column：编辑整列。
• insert_row：插入新行。
• insert_column：插入新列。
• rename_sheet：重命名工作表。
• rename_doc：重命名电子表格。

常见问题解答

• 如何认证 Google 账户？：在启动 MCP 服务器时，系统会自动提示认证。
• 如何创建新的电子表格？：使用 create_spreadsheet 操作。
• 如何读取特定行或列？：使用 read_rows 或 read_columns 操作。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 克隆仓库并安装依赖：

git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp
npm install

安装教程

1. 构建项目：

npm run build

1. 在 Google Cloud Platform 创建 OAuth 凭证：
2. 创建新项目并启用 Google Sheets API。
3. 配置 OAuth 同意屏幕并创建客户端 ID（桌面应用）。
4. 下载凭证并保存为 gcp-oauth.keys.json 到 dist 目录。
5. 启动 MCP 服务器：

npm run start

调试方式

1. 启动服务器后，系统会提示认证 Google 账户。
2. 使用提供的操作（如 list_sheets）测试连接和功能。
3. 检查日志输出以排查问题。

许可证

该项目遵循 MIT 开源许可条款。