Google Sheets MCP Server

基本能力

产品定位

Google Sheets MCP Server 是一个专门用于与Google Sheets API集成的服务，旨在通过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的连接

常见问题解答

• 认证问题：确保正确设置服务账户密钥或API密钥
• 权限问题：检查OAuth范围是否足够
• 连接问题：验证网络连接和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文件中

调试方式

• 检查服务器日志以获取错误信息
• 使用google_sheets_verify_connection工具验证API连接
• 确保所有环境变量已正确设置

许可证

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