用途:通过 Rube MCP 与 Composio 的 Google Sheets 工具集,自动化表格数据的读写、工作表管理、格式化、筛选和按键更新。
前置条件:Rube MCP 已连接且 RUBE_SEARCH_TOOLS 可用;需通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 googlesheets 的 ACTIVE 连接。设置时在客户端添加 MCP 服务器地址 https://rube.app/mcp,无需 API 密钥,再通过返回的授权链接完成 Google OAuth。
主要能力与用法:
- 读写数据:用 GOOGLESHEETS_SEARCH_SPREADSHEETS 按名称找表,GET_SHEET_NAMES 列出标签,BATCH_GET 读范围,BATCH_UPDATE、VALUES_UPDATE 或 SPREADSHEETS_VALUES_APPEND 写数据。spreadsheet_id 取 URL 中 /d/ 与 /edit 之间;ranges 用 A1 记法;values 为二维数组;valueInputOption 可选 USER_ENTERED 或 RAW。
- 管理表格:CREATE_GOOGLE_SHEET1 新建、ADD_SHEET 添加标签、UPDATE_SHEET_PROPERTIES 重命名/隐藏/排序/着色、GET_SPREADSHEET_INFO 获取元数据、FIND_WORKSHEET_BY_TITLE 检查标签是否存在。
- 搜索筛选:LOOKUP_SPREADSHEET_ROW 按完整单元格值匹配首行,SET_BASIC_FILTER 与 CLEAR_BASIC_FILTER 管理筛选与排序。
- Upsert:UPSERT_ROWS 按 keyColumn 表头匹配更新或追加,可自动补列。
- 格式化:FORMAT_CELL 需数字 worksheet_id 而非标签名,颜色通道为 0.0-1.0 浮点数,range 用 A1 记法,每次一个范围。
限制与注意:Google Sheets 限速约 60 次读取/分钟和 60 次写入/分钟,应尽量批量操作;避免无界范围以防超时;标签名区分大小写且受区域设置影响;含空格标签在 A1 记法中需单引号;所有 values 必须是二维数组;DELETE_DIMENSION 不可逆。输出不应替代环境验证、测试或专家审查;若输入、权限或成功标准缺失应停下并询问。