---

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 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用工具包 googlesheets 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Google OAuth
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 读取和写入数据

何时使用：用户想要从 Google Sheet 读取数据或向其写入数据

工具序列：

1. GOOGLESHEETS_SEARCH_SPREADSHEETS - 如果 ID 未知，按名称查找电子表格 [前提]
2. GOOGLESHEETS_GET_SHEET_NAMES - 枚举标签页名称以定位正确的工作表 [前提]
3. GOOGLESHEETS_BATCH_GET - 从一个或多个范围读取数据 [必需]
4. GOOGLESHEETS_BATCH_UPDATE - 向范围写入数据或追加行 [必需]
5. GOOGLESHEETS_VALUES_UPDATE - 更新单个特定范围 [替代]
6. 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. 创建和管理电子表格

何时使用：用户想要创建新电子表格或管理其中的标签页

工具序列：

1. GOOGLESHEETS_CREATE_GOOGLE_SHEET1 - 创建新电子表格 [必需]
2. GOOGLESHEETS_ADD_SHEET - 添加新标签页/工作表 [必需]
3. GOOGLESHEETS_UPDATE_SHEET_PROPERTIES - 重命名、隐藏、重排序或着色标签页 [可选]
4. GOOGLESHEETS_GET_SPREADSHEET_INFO - 获取完整电子表格元数据 [可选]
5. GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE - 检查特定标签页是否存在 [可选]

关键参数：

• title：电子表格或工作表标签页名称
• spreadsheetId：目标电子表格 ID
• forceUnique：如果标签页名称存在则自动追加后缀（默认 true）
• properties.gridProperties：设置行/列数、冻结行

陷阱：

• 电子表格内的工作表名称必须唯一
• 默认工作表名称取决于区域设置（英语为 'Sheet1'，西班牙语为 'Hoja 1'）
• 并行创建多个工作表时不要使用 index（会导致 'index too high' 错误）
• 如果账户缺少访问权限，GOOGLESHEETS_GET_SPREADSHEET_INFO 可能返回 403

3. 搜索和筛选行

何时使用：用户想要查找特定行或对工作表数据应用筛选器

工具序列：

1. GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW - 查找匹配精确单元格值的第一行 [必需]
2. GOOGLESHEETS_SET_BASIC_FILTER - 对范围应用筛选/排序 [替代]
3. GOOGLESHEETS_CLEAR_BASIC_FILTER - 移除现有筛选器 [可选]
4. 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. 按键更新插入行