Notion Sync

使用说明

Notion Sync 提供与 Notion API 的深度集成，支持对页面和数据库进行完整 CRUD 操作。适合构建知识管理系统、任务跟踪自动化和文档同步工作流。

clawhub install notion-sync

核心功能

• 页面管理：创建、读取、更新、归档 Notion 页面
• 数据库操作：查询、筛选、排序数据库条目，支持复杂条件组合
• 块级操作：添加、修改、删除块（段落、标题、列表、代码块等）
• 属性处理：支持所有 Notion 属性类型（标题、选择、多选、日期、关联等）
• 双向同步：外部数据与 Notion 保持一致

配置

export NOTION_TOKEN=secret_xxxxxxxxxxxxx

首次使用需将 Integration 添加到目标数据库或页面。

使用示例

在「项目数据库」中创建一个新页面，标题「Q2 规划」，状态设为「进行中」

查询任务数据库中所有状态为「待处理」的条目

把这个页面状态更新为「已完成」

注意事项

1. Notion API 速率限制：每秒 3 个请求，批量操作需加延迟
2. 数据库需手动授权 Integration 访问权限
3. 公式和 Rollup 属性仅支持读取
4. 单个页面建议不超过 500 个块

高级用法

• 批量同步外部 API 数据到 Notion 数据库
• Webhook 监听页面变化，触发自动化工作流
• 定时同步 Agent 工作记忆到 Notion 知识库