用途 该工具用于通过托管在 https://mcp.notion.com/mcp 的 Notion MCP 服务器，与 Notion 页面、数据库和工作区内容进行交互，实现搜索、读取、创建和更新等操作。
主要能力 通过命令行工具 notion-cli 提供两类能力：一是连接管理，包括查看状态、生成授权链接、用授权码换取令牌、刷新令牌和断开连接；二是 MCP 操作，包括列出可用工具清单，以及按工具名与 JSON 参数调用具体工具。列出工具后可查看每个工具的 input_schema 以确定参数结构。
使用方式 所有操作通过 exec 运行 notion-cli <子命令> [选项]。连接管理命令为 status、authorize-url、exchange-code --code <code> [--redirect-uri <url>]、refresh、disconnect。MCP 操作为 list-tools 和 call-tool --name <tool> --arguments-json '<json-object>'，其中 arguments-json 必须是 JSON 对象，数组或标量会被拒绝。
首次使用流程 先运行 notion-cli status；若状态为 not_connected，运行 notion-cli authorize-url，当输出包含 connect_url 时，将其以 Markdown 链接 Connect Notion 形式分享，等待用户完成授权。授权后浏览器经 Muse 中继跳回虚拟机，authd 自动完成授权码交换，代理在令牌到位后继续。随后再次运行 status，状态变为 connected 后输出会包含发现的 MCP 工具目录。若环境未接入中继，可在获得授权码后手动执行 exchange-code。
认证说明 OAuth 由 authd 通过动态客户端注册与 PKCE（S256）处理，访问令牌保存在 $JARVIS_HOME/user/auth/notion.json，不应手动编辑该文件。遇到 401 时会自动刷新令牌；若 call-tool 持续返回未授权，可显式运行 refresh 或请用户重新授权。
操作规则 进行任何 MCP 工作前先运行 status；未连接则先完成设置流程。除非已知工具名及参数结构，调用 call-tool 前应先运行 list-tools，不要猜测工具名。对会修改 Notion 页面、数据库或块的工具调用，应先确认用户意图。读取结果保留 Notion 原始日期字段，并为记录创建/编辑时间及带时间的日期属性附加语义化的 UTC 与用户本地时间形式；仅日期属性仍保持日期形式。
适用场景与限制 适用于需要以命令行方式在 Notion 中检索、读取、创建和更新内容的自动化或代理场景，尤其适合已接入 Muse 中继的受管环境。资料未说明速率限制、权限范围细则、支持的工具完整清单及非托管环境的替代方案，这些方面暂未提供。