用途：让智能体以两种方式访问 Notion——官方 ntn CLI（macOS/Linux，语法更短、支持一行文件上传，Workers 必需）或 HTTP + curl（跨平台，Windows 默认回退）。两者共用同一个集成令牌。
主要能力：搜索页面、读取页面元数据、以 Markdown 或块结构读取页面内容、用 Markdown 创建与更新页面、查询数据源（数据库）、创建数据源、更新页面属性、追加块、上传文件；进阶可用 ntn workers 构建 Notion 托管的 TypeScript 程序，暴露同步（Syncs）、工具（Tools）和 Webhook。
使用方式：先在 https://notion.so/my-integrations 创建集成并复制 API key（ntn_ 或 secret_ 开头），存入 ${HERMES_HOME:-~/.hermes}/.env 的 NOTION_API_KEY，并在 Notion 中把目标页面/数据库共享给该集成，否则返回 404。安装 ntn：curl -fsSL https://ntn.dev | bash 或 npm install --global ntn（需 Node 22+、npm 10+），用 ntn --version 验证；跳过 ntn login，改用 export NOTION_API_TOKEN=$NOTION_API_KEY 与 export NOTION_KEYRING=0。运行时用 command -v ntn 判断走 CLI 还是 curl。HTTP 请求必须带 Notion-Version: 2025-09-03。
限制：API 版本 2025-09-03 中数据库改称 data source，查询用 /v1/data_sources/{id}/query，创建页面仍用 database_id。速率约每秒 3 次请求，CLI 不绕过。API 无法设置数据库视图过滤器（仅 UI）。ntn 截至 2026 年 5 月仅支持 macOS/Linux，Windows 需 WSL2 或等待原生支持；部署 Workers 需 Business 或 Enterprise 计划，2026 年 8 月 11 日前免费，之后按 Notion credits 计费。页面/数据库 ID 为 UUID，带或不带连字符均可。其他细节暂未提供。