notion-cli
Notion官方API的命令行工具，一个二进制文件集成39个命令。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：notion-cli。 它的用途是：Notion官方API的命令行工具，一个二进制文件集成39个命令。 完整的 Skill 内容见：https://321skill.com/skills/notion-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把这个Markdown文件的内容追加到Notion的‘项目日志’页面末尾。”，AI Agent可以使用notion-cli执行 `notion block append <page-id> --file log.md` 命令来完成。或者，
对AI说：“查询‘任务’数据库中所有状态为‘进行中’的条目。”，AI Agent可以调用 `notion db query <db-id> --filter 'Status=进行中'` 来获取数据。
介绍
notion-cli 是一款功能完整的 Notion 命令行工具，旨在为开发者、脚本和AI Agent提供无需浏览器的程序化访问能力。它解决了在终端中直接管理Notion内容（如页面、数据库、块、评论、用户和文件）的需求，让自动化操作和集成变得简单。
使用方式非常便捷，支持多种安装途径，包括Homebrew、Go、npm、Scoop、Docker或直接下载二进制文件。安装后，通过设置环境变量 NOTION_TOKEN 或使用 notion auth login --with-token 命令进行身份验证，即可使用其丰富的命令集进行搜索、查询、创建和修改等操作。
该工具非常适合需要在工作流中集成Notion的开发者、使用脚本进行批量操作的效率追求者，以及需要程序化读写Notion数据的AI Agent。它提供了对Notion API资源的广泛CRUD支持，是自动化任务和构建集成方案的强大助手。
与Notion官方后来推出的 ntn CLI相比，notion-cli的核心区别在于：它是一个完全开源的独立项目，支持Windows平台，并且提供了更全面的资源操作覆盖（如完整的数据库CRUD、块、评论、用户管理），而 ntn 更侧重于Notion Workers的构建部署和有限的资源访问。两者设计意图不同，可以共存。
核心特点
这是一个完全开源、跨平台（包括Windows）的第三方CLI，提供了对Notion API几乎所有资源（页面、数据库、块、评论、用户、文件、搜索）的完整CRUD操作，特别适合脚本和AI Agent通过长期有效的集成令牌进行驱动。
注意事项
不适合需要浏览器OAuth登录、或主要为了构建和部署Notion Workers的用户。
常见问题
notion-cli和官方的ntn CLI有什么区别？
notion-cli是开源第三方工具，支持Windows和完整资源CRUD；ntn是官方工具，支持OAuth和Notion Workers，但不开源且不支持Windows。
如何安装notion-cli？
可通过Homebrew、Go、npm、Scoop、Docker或直接从GitHub Releases下载二进制文件安装。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/notion-cli/raw/index.md 读取 notion-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/notion-cli/raw/index.md（查看排版版本）