MCP Google Spreadsheet

MCP Google Spreadsheet

site icon
2025.04.03 10
GoGoogle表格操作Google Drive管理AI助手集成交流协作
MCP Google Spreadsheet 是一个基于 Model Context Protocol (MCP) 实现的 Google Spreadsheet 和 Google Drive 操作工具。它允许AI助手通过MCP协议与Google Spreadsheet和Google Drive进行交互,实现文件管理和表格操作。
View on GitHub

Overview

基本能力

产品定位

MCP Google Spreadsheet 是一个连接AI助手与Google表格/云盘服务的中间件,使AI能够自动化操作电子表格和文件管理。

核心功能

Google Drive 操作

  • list_files: 获取Google Drive文件列表
  • copy_file: 复制Google Drive文件
  • rename_file: 重命名Google Drive文件

Google Spreadsheet 操作

  • list_sheets: 获取电子表格中的工作表列表
  • copy_sheet: 复制工作表
  • rename_sheet: 重命名工作表
  • get_sheet_data: 获取工作表数据
  • add_rows: 添加行
  • add_columns: 添加列
  • update_cells: 更新单个单元格范围
  • batch_update_cells: 批量更新多个单元格范围

适用场景

  1. AI助手自动化处理Google表格数据
  2. 批量修改或分析电子表格内容
  3. 自动化文件管理任务
  4. 团队协作中的数据同步与更新

工具列表

  • mcp-google-spreadsheet 主程序:提供Google表格/云盘的API接口

常见问题解答

  1. 首次运行时需要完成Google账户认证
  2. 操作仅限于指定的Google Drive文件夹
  3. 防止目录遍历攻击等安全风险

使用教程

使用依赖

  1. Go 1.24+ 环境
  2. Google Cloud Platform项目
  3. 已启用的Google Drive API和Google Sheets API

安装教程

go install github.com/kazz187/mcp-google-spreadsheet@latest

环境变量配置

export MCPGS_CLIENT_SECRET_PATH=/path/to/client_secret.json
export MCPGS_TOKEN_PATH=/path/to/token.json
export MCPGS_FOLDER_ID=your_folder_id

调试方式

  1. 启动服务:
mcp-google-spreadsheet
  1. 首次运行会打开浏览器进行Google账户认证
  2. 检查环境变量是否正确设置
  3. 确认API访问权限

许可证

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