
关于
通过 Rube MCP(Composio)自动化 Google Sheets 操作(读写、格式化、过滤、管理电子表格)。以编程方式读写数据、管理标签页、应用格式和搜索行。
name: googlesheets-automation description: "通过 Rube MCP(Composio)自动化 Google Sheets 操作(读取、写入、格式化、筛选、管理电子表格)。以编程方式读写数据、管理标签页、应用格式和搜索行。" risk: critical source: community date_added: "2026-02-27"
通过 Rube MCP 实现 Google Sheets 自动化
通过 Composio 的 Google Sheets 工具包自动化 Google Sheets 工作流,包括读写数据、管理电子表格和标签页、格式化单元格、筛选行和更新插入记录。
前提条件
- Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)
- 通过
RUBE_MANAGE_CONNECTIONS使用工具包googlesheets建立活跃的 Google Sheets 连接 - 始终先调用
RUBE_SEARCH_TOOLS获取当前工具模式
设置
获取 Rube MCP:在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。
- 确认
RUBE_SEARCH_TOOLS有响应来验证 Rube MCP 可用 - 使用工具包
googlesheets调用RUBE_MANAGE_CONNECTIONS - 如果连接不是 ACTIVE 状态,按照返回的认证链接完成 Google OAuth
- 在运行任何工作流之前确认连接状态显示 ACTIVE
核心工作流
1. 读取和写入数据
何时使用:用户想要从 Google Sheet 读取数据或向其写入数据
工具序列:
GOOGLESHEETS_SEARCH_SPREADSHEETS- 如果 ID 未知,按名称查找电子表格 [前提]GOOGLESHEETS_GET_SHEET_NAMES- 枚举标签页名称以定位正确的工作表 [前提]GOOGLESHEETS_BATCH_GET- 从一个或多个范围读取数据 [必需]GOOGLESHEETS_BATCH_UPDATE- 向范围写入数据或追加行 [必需]GOOGLESHEETS_VALUES_UPDATE- 更新单个特定范围 [替代]GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND- 向表格末尾追加行 [替代]
关键参数:
spreadsheet_id:电子表格 URL 中的字母数字 ID(在 '/d/' 和 '/edit' 之间)ranges:A1 表示法数组(例如 'Sheet1!A1:Z1000');始终使用有界范围sheet_name:标签页名称(支持不区分大小写匹配)values:二维数组,每个内部数组是一行first_cell_location:A1 表示法的起始单元格(省略则追加)valueInputOption:'USER_ENTERED'(解析)或 'RAW'(字面值)
陷阱:
- 大小写错误或不存在的标签页名称会报错 "Sheet 'X' not found"
- 空范围可能省略
valueRanges[i].values;将缺失视为空数组 GOOGLESHEETS_BATCH_UPDATE的 values 必须是二维数组(列表的列表),即使只有一行- 在超过 10,000 行的工作表上使用无界范围如 'A:Z' 可能导致超时;始终用行限制来约束
- 追加遵循检测到的
tableRange;使用返回的updatedRange验证放置位置
2. 创建和管理电子表格
何时使用:用户想要创建新电子表格或管理其中的标签页
工具序列:
GOOGLESHEETS_CREATE_GOOGLE_SHEET1- 创建新电子表格 [必需]GOOGLESHEETS_ADD_SHEET- 添加新标签页/工作表 [必需]GOOGLESHEETS_UPDATE_SHEET_PROPERTIES- 重命名、隐藏、重排序或着色标签页 [可选]GOOGLESHEETS_GET_SPREADSHEET_INFO- 获取完整电子表格元数据 [可选]GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE- 检查特定标签页是否存在 [可选]
关键参数:
title:电子表格或工作表标签页名称spreadsheetId:目标电子表格 IDforceUnique:如果标签页名称存在则自动追加后缀(默认 true)properties.gridProperties:设置行/列数、冻结行
陷阱:
- 电子表格内的工作表名称必须唯一
- 默认工作表名称取决于区域设置(英语为 'Sheet1',西班牙语为 'Hoja 1')
- 并行创建多个工作表时不要使用
index(会导致 'index too high' 错误) - 如果账户缺少访问权限,
GOOGLESHEETS_GET_SPREADSHEET_INFO可能返回 403
3. 搜索和筛选行
何时使用:用户想要查找特定行或对工作表数据应用筛选器
工具序列:
GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW- 查找匹配精确单元格值的第一行 [必需]GOOGLESHEETS_SET_BASIC_FILTER- 对范围应用筛选/排序 [替代]GOOGLESHEETS_CLEAR_BASIC_FILTER- 移除现有筛选器 [可选]GOOGLESHEETS_BATCH_GET- 读取筛选结果 [可选]
关键参数:
query:要匹配的精确文本值(匹配整个单元格内容)range:要搜索的 A1 表示法范围case_sensitive:区分大小写匹配的布尔值(默认 false)filter.range:带有 sheet_id 的网格范围用于基本筛选filter.criteria:基于列的筛选条件filter.sortSpecs:排序规格
陷阱:
GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW匹配整个单元格内容,而非子字符串- 带空格的工作表名称在范围中必须用单引号括起来(例如 "'My Sheet'!A:Z")
- 不支持不带范围的裸工作表名称进行查找;始终指定范围
4. 按键更新插入行
兼容工具
Claude CodeCursor
标签
后端开发
