用途：notion-pp-cli 是驱动 Notion 的命令行工具，用于在终端管理页面与块、检测陈旧页面、追踪自某时间点以来的变更。它不能替代 Notion 网页界面做日常编辑。
安装与验证：先确认 CLI 已安装，缺失时安装：npx -y @mvanhorn/printing-press-library install notion --cli-only；验证：notion-pp-cli --version。若 npx 安装失败，可回退到 Go 安装（需 Go 1.26.6 或更新）：go install github.com/mvanhorn/printing-press-library/library/productivity/notion/cmd/notion-pp-cli@latest。安装目录需在 $PATH 中。
主要能力：changed 显示自上次同步或指定时间以来新增、编辑、删除的内容，如 notion-pp-cli changed --since 2h --json；stale 列出 N 天未编辑的页面，可按数据库、父级或标签过滤，如 notion-pp-cli stale --days 30 --db ProjectDB --agent。命令覆盖 blocks、comments、custom-emojis、data-sources、databases、file-uploads、notion-search、oauth、pages、users、views，以及 sync pages（同步全部页面与数据库到本地 SQLite，支持 --full、--type database）。
使用方式：需 Notion 内部集成令牌，在 notion.so/my-integrations 创建并共享顶层页面，设置 NOTION_BEARER_AUTH 或 NOTION_TOKEN。首次运行：notion-pp-cli doctor 验证认证，notion-pp-cli sync pages 同步，之后 stale 与 changed 可离线使用。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes；支持 --select 过滤字段、--dry-run 预览、--deliver 输出到 stdout、file:<path> 或 webhook:<url>，以及命名 profile。
限制：需先安装并验证 CLI，否则不要执行技能命令；同步约 15k 页面耗时 2-3 分钟；退出码区分用法错误、未找到、需认证、API 错误、限流等。MCP 服务器安装：go install github.com/mvanhorn/printing-press-library/library/productivity/notion/cmd/notion-pp-mcp@latest，注册：claude mcp add notion-pp-mcp -- notion-pp-mcp。