Google Sheets MCP Server

基本能力

产品定位

Google Sheets MCP Server 是一个专门用于与 Google Sheets API 集成的服务，旨在通过 MCP 协议为 AI 助手提供对 Google Sheets 的全面操作能力。

核心功能

• 创建、读取、更新和删除 Google Sheets
• 管理表格数据，支持单元格级别的操作
• 格式化单元格和范围
• 与其他用户共享电子表格
• 搜索电子表格
• 提供全面的认证选项

适用场景

• AI 助手需要自动化管理 Google Sheets 的场景
• 团队协作中需要自动化处理电子表格数据的场景
• 需要批量操作或格式化电子表格的场景
• 需要将数据自动导入或导出 Google Sheets 的场景

工具列表

• google_sheets_create: 创建新的 Google Sheet
• google_sheets_get: 通过 ID 获取 Google Sheet
• google_sheets_update_values: 更新 Google Sheet 中的值
• google_sheets_append_values: 向 Google Sheet 追加值
• google_sheets_get_values: 从 Google Sheet 获取值
• google_sheets_clear_values: 清除 Google Sheet 中的值
• google_sheets_add_sheet: 向现有电子表格添加新工作表
• google_sheets_delete_sheet: 从电子表格中删除工作表
• google_sheets_list: 列出认证用户可访问的 Google Sheets
• google_sheets_delete: 删除 Google Sheet
• google_sheets_share: 与特定用户共享 Google Sheet
• google_sheets_search: 按标题搜索 Google Sheets
• google_sheets_format_cells: 格式化 Google Sheet 中的单元格
• google_sheets_verify_connection: 验证与 Google Sheets API 的连接

使用教程

使用依赖

• Node.js (v16 或更高版本)
• 启用了 Google Sheets API 的 Google Cloud 项目
• 认证凭证

安装教程

1. 克隆仓库: bash git clone https://github.com/yourusername/google-sheets-mcp-server.git cd google-sheets-mcp-server

2. 安装依赖: bash npm install

3. 设置认证:

4. 基于 .env.example 模板创建 .env 文件

5. 添加您的 Google Cloud 凭证

6. 构建项目: bash npm run build

7. 启动服务器: bash npm start

OAuth 设置

1. 在 Google Cloud Console 中创建 OAuth 凭证
2. 更新 src/get-refresh-token.js 中的 CLIENT_ID 和 CLIENT_SECRET
3. 安装所需依赖: bash npm install open server-destroy
4. 运行脚本获取刷新令牌: bash node src/get-refresh-token.js
5. 按照浏览器提示授权应用程序
6. 将刷新令牌复制到 .env 文件中

调试方式

启动服务器后，可以通过以下方式测试功能: 1. 创建新的电子表格 2. 添加数据到电子表格 3. 格式化电子表格 4. 共享电子表格

常见问题解答

1. 认证失败怎么办？
2. 检查您的凭证是否正确
3. 确保 Google Sheets API 已启用

4. 验证您的 OAuth 令牌是否有效

5. 如何解决权限问题？

6. 确保服务账户或用户有足够的权限

7. 检查共享设置是否正确

8. API 调用限制如何处理？

9. Google Sheets API 有配额限制，建议批量操作时添加适当延迟

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。