---

name: notion-automation description: "通过 Rube MCP (Composio) 自动化 Notion 任务：页面、数据库、块、评论、用户。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Notion 自动化

通过 Composio 的 Notion 工具包经由 Rube MCP 自动化 Notion 操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Notion 连接，toolkit 为 notion
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

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

核心工作流

1. 创建和管理页面

使用场景：用户想要创建、更新或归档 Notion 页面

工具调用顺序：

1. NOTION_SEARCH_NOTION_PAGE - 查找父页面或现有页面 [前置]
2. NOTION_CREATE_NOTION_PAGE - 在父页面下创建新页面 [可选]
3. NOTION_RETRIEVE_PAGE - 获取页面元数据/属性 [可选]
4. NOTION_UPDATE_PAGE - 更新页面属性、标题、图标、封面 [可选]
5. NOTION_ARCHIVE_NOTION_PAGE - 软删除（归档）页面 [可选]

关键参数：

• query：SEARCH_NOTION_PAGE 的搜索文本
• parent_id：父页面或数据库 ID
• page_id：用于检索/更新/归档的页面 ID
• properties：匹配父 schema 的页面属性值

注意事项：

• RETRIEVE_PAGE 仅返回元数据/属性，不返回正文内容；使用 FETCH_BLOCK_CONTENTS 获取页面正文
• ARCHIVE_NOTION_PAGE 是软删除（设置 archived=true），不是永久删除
• 广泛搜索可能看起来不完整，除非完全分页处理 has_more/next_cursor

2. 查询和管理数据库

使用场景：用户想要查询数据库行、插入条目或更新记录

工具调用顺序：

1. NOTION_SEARCH_NOTION_PAGE - 按名称查找数据库 [前置]
2. NOTION_FETCH_DATABASE - 检查 schema 和属性 [前置]
3. NOTION_QUERY_DATABASE / NOTION_QUERY_DATABASE_WITH_FILTER - 查询行 [必需]
4. NOTION_INSERT_ROW_DATABASE - 添加新条目 [可选]
5. NOTION_UPDATE_ROW_DATABASE - 更新现有条目 [可选]

关键参数：

• database_id：数据库 ID（来自搜索或 URL）
• filter：匹配 Notion 过滤器语法的过滤对象
• sorts：排序对象数组
• start_cursor：上一响应的分页游标
• properties：匹配数据库 schema 的属性值，用于插入/更新

注意事项：

• 404 object_not_found 通常意味着 database_id 错误或数据库未与集成共享
• 结果是分页的；忽略 has_more/next_cursor 会静默截断读取
• Schema 不匹配或缺少必需属性会导致 400 validation_error
• 公式和只读字段无法通过 INSERT_ROW_DATABASE 设置
• 过滤器中的属性名称必须与 schema 完全匹配（区分大小写）

3. 管理块和页面内容

使用场景：用户想要读取、追加或修改页面中的内容块

工具调用顺序：

1. NOTION_FETCH_BLOCK_CONTENTS - 读取页面的子块 [必需]
2. NOTION_ADD_MULTIPLE_PAGE_CONTENT - 向页面追加块 [可选]
3. NOTION_APPEND_TEXT_BLOCKS - 追加纯文本块 [可选]
4. NOTION_REPLACE_PAGE_CONTENT - 替换所有页面内容 [可选]
5. NOTION_DELETE_BLOCK - 删除特定块 [可选]

关键参数：

• block_id / page_id：目标页面或块 ID
• content_blocks：块对象数组（不是 child_blocks）
• text：APPEND_TEXT_BLOCKS 的纯文本内容

注意事项：

• 使用 content_blocks 参数，不是 child_blocks——后者会验证失败
• ADD_MULTIPLE_PAGE_CONTENT 在已归档页面上会失败；先通过 UPDATE_PAGE 取消归档
• 创建的块在 response.data.results 中；保存块 ID 以便后续编辑
• DELETE_BLOCK 是归档操作（archived=true），不是永久删除

4. 管理数据库 Schema

使用场景：用户想要创建数据库或修改其结构

工具调用顺序：

1. NOTION_FETCH_DATABASE - 检查当前 schema [前置]
2. NOTION_CREATE_DATABASE - 创建新数据库 [可选]
3. NOTION_UPDATE_SCHEMA_DATABASE - 修改数据库属性 [可选]

关键参数：

• parent_id：新数据库的父页面 ID
• title：数据库标题
• properties：包含类型和选项的属性定义
• database_id：用于 schema 更新的数据库 ID

注意事项：

• 无法通过 UPDATE_SCHEMA 更改属性类型；必须创建新属性并迁移数据
• 公式、汇总和关联属性具有复杂配置