用途:通过 Rube MCP(Composio)的 Google Sheets 工具包自动化表格工作流,涵盖读取/写入数据、管理电子表格与工作表标签、格式化单元格、筛选行以及按唯一键 upsert 记录。
前置条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS(工具包 googlesheets)建立有效的 Google Sheets 连接;执行任何工作流前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
设置:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥。确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS(工具包 googlesheets);若连接非 ACTIVE,按返回的授权链接完成 Google OAuth,确认状态为 ACTIVE 再运行工作流。
主要能力:1) 读写数据:GOOGLESHEETS_SEARCH_SPREADSHEETS 按名称查 ID、GOOGLESHEETS_GET_SHEET_NAMES 枚举标签、GOOGLESHEETS_BATCH_GET 读取范围、GOOGLESHEETS_BATCH_UPDATE 写入或追加、GOOGLESHEETS_VALUES_UPDATE 更新单范围、GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND 追加行。2) 创建与管理:GOOGLESHEETS_CREATE_GOOGLE_SHEET1、GOOGLESHEETS_ADD_SHEET、GOOGLESHEETS_UPDATE_SHEET_PROPERTIES、GOOGLESHEETS_GET_SPREADSHEET_INFO、GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE。3) 搜索与筛选:GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW、GOOGLESHEETS_SET_BASIC_FILTER、GOOGLESHEETS_CLEAR_BASIC_FILTER。4) 按唯一键 upsert:GOOGLESHEETS_UPSERT_ROWS。5) 格式化:GOOGLESHEETS_FORMAT_CELL。
关键参数:spreadsheet_id 取自 URL 中 /d/ 与 /edit 之间;ranges 用 A1 表示法并始终设定行边界;values 为二维数组(列表的列表);valueInputOption 取 USER_ENTERED 或 RAW;格式化需数值 worksheet_id 而非标签名,颜色为 0.0-1.0 浮点数。
限制与陷阱:工作表名区分大小写、默认名随语言环境变化;含空格的工作表名在 A1 表示法中需加单引号;无边界范围在大表上可能超时;LOOKUP 匹配整个单元格内容而非子串;UPSERT 的 keyColumn 必须是真实表头名而非列字母;Google Sheets 限速约每分钟 60 次读和 60 次写,应尽量批处理;GOOGLESHEETS_DELETE_DIMENSION 不可逆,需仔细核对范围。
适用场景:CRM 同步、库存更新、去重、批量数据读写与格式化等表格自动化任务。
工具文档:composio.dev/toolkits/googlesheets。由 Composio 提供支持。