命令行掌控 Notion 工作空间 - Notion CLI – Command Line Interface based access to Notion for your agent

通过命令行工具全面管理 Notion 工作空间，支持页面、数据库、块、用户和评论的搜索、创建与管理，支持 JSON/表格/CSV 多格式输出。

基本信息

• 技能名称?Notion CLI – Command Line Interface based access to Notion for your agent
• 中文名称?命令行掌控 Notion 工作空间
• 作者?froemic
• 分类?专业技能
• 版本?1.0.0
• 标签?notion, cli, api-client, productivity, automation, database, workspace-management, developer-tool

使用方法

使用说明
核心用法
notion-cli 是一款面向 Notion API 的生产级命令行工具，允许用户在不离开终端的情况下完整操作 Notion 工作空间。核心功能覆盖六大对象类型：
搜索与发现 ： notion search 命令可跨工作空间检索页面、数据库和数据源，支持按类型过滤和编辑时间排序。
页面管理 ：支持获取详情、创建、更新属性、归档/恢复等完整生命周期操作。页面 ID 兼容 UUID 和 Notion URL 两种格式。
数据库操作 ：可查询 schema、创建数据库、执行带过滤条件和排序的数据查询。 databases query 支持复杂 JSON 过滤，适合自动化数据提取。
内容块编辑 ： blocks 命令族支持读取、追加、更新和删除页面内容块，涵盖段落、标题、列表、代码块等富文本元素。
用户与协作 ：列出工作空间成员、获取用户信息，以及完整的评论系统（查看和创建）。
输出灵活性 ：全局 -f 选项支持 JSON（默认）、表格、CSV 三种格式，便于脚本集成和数据处理。
显著优点
功能完整性 ：覆盖 Notion API 的核心端点，单工具即可替代多种零散脚本
开发者友好 ：支持环境变量和命令行双重认证，自动重试机制应对 API 限流
格式互操作 ：JSON 便于编程处理，表格适合快速查阅，CSV 支持 Excel 生态
集成便捷 ：与 Claude Code 等 AI 编程工具兼容，可配置于 ~/.claude/.env
潜在局限
手动权限配置 ：每个页面/数据库需在 Notion UI 中手动共享给集成，无法自动发现可访问资源
学习成本 ：复杂过滤和属性更新需掌握 Notion API 的 JSON 结构，非图形界面用户可能感到门槛
自托管维护 ：需手动克隆、构建、链接，无官方 npm 包分发，更新依赖 git 操作
属性类型复杂度 ：formula、rollup、relation 等高级字段的操作需深入理解 API 文档
适合人群
习惯终端工作流的开发者和技术团队
需要批量操作 Notion 数据的自动化场景（CI/CD、数据同步、报告生成）
将 Notion 作为轻量级 CMS/数据库的后端开发者
与 Claude Code 等 AI 编码助手结合使用的用户
常规风险
密钥管理 ： NOTION_API_KEY 需妥善保管，硬编码或日志泄露可能导致工作空间数据暴露
权限范围 ：集成拥有所共享资源的完整读写权限，误操作可能导致数据丢失
API 限流 ：虽内置重试机制，但高频批量操作仍可能触发 Notion 速率限制
数据一致性 ：并发编辑场景下可能出现版本冲突，CLI 暂未暴露乐观锁或版本校验机制