用途:让智能体通过 Notion API 或 ntn 官方 CLI 访问 Notion,完成页面检索、读写、数据库查询、Markdown 内容操作与文件上传;进阶可用 ntn workers 在 Notion 上托管 TypeScript 程序。
准备:在 https://notion.so/my-integrations 创建 integration 获取 token(ntn_ 或 secret_ 开头),写入 ${HERMES_HOME:-~/.hermes}/.env 的 NOTION_API_KEY;须在 Notion 页面菜单 ... → Connect to 中把目标页面/数据库共享给该 integration,否则返回 404(即使页面存在)。
两种路径:macOS/Linux 默认用 ntn CLI(安装:curl -fsSL https://ntn.dev | bash 或 npm install --global ntn,需 Node 22+、npm 10+),跳过 ntn login,改用 export NOTION_API_TOKEN=$NOTION_API_KEY 与 export NOTION_KEYRING=0;Windows 暂用 HTTP + curl(Win10+ 自带 curl 可用),也可在 WSL2 内装 ntn。运行时按 command -v ntn 选择。
主要能力:搜索、读取页面元数据、以 Markdown 读页面(适合喂给模型)、以 blocks 读结构、用 Markdown 建页/改页、查询 data source、创建数据库、更新属性、追加 blocks、三步式文件上传(create → PUT bytes → 引用),以及 Workers 的 syncs / tools / webhooks。
限制:所有 HTTP 请求须带 Notion-Version: 2025-09-03(ntn 自动处理);约 3 请求/秒限速;API 无法设置数据库视图过滤器(仅 UI 可设);Workers 部署需 Business 或 Enterprise 计划,2026-08-11 前免费、之后按 Notion credits 计费;ntn 截至 2026 年 5 月仅支持 macOS/Linux;文档未提供更多平台或价格细节。