Notion Cli

4ier/notion-cli/skills/notion-cli

作者 4iera48f66f30740无许可证247 个星标收录于 2026年10月8日更新于 2026年10月8日仓库2个月前更新

Work with Notion from the terminal using the `notion` CLI. Use when the user needs to read, create, update, query, or manage Notion pages, databases, blocks, comments, users, or files programmatically. Covers the entire Notion API with 50+ commands. Triggers: Notion workspace automation, database queries, page creation, block manipulation, comment threads, file uploads, relation management, database export, multi-workspace management, or any Notion API interaction from the command line.

仅含说明Productivity & Workflow
AI 生成的概览

指导使用 notion 命令行工具读取、创建、更新、查询和管理 Notion 页面、数据库、块、评论、用户与文件。

功能
该技能是 notion 命令行工具的参考指南，该工具封装了 Notion API。它记录了安装、认证，以及搜索、页面、数据库、块、评论、用户、文件和原始 API 调用等命令，并说明输出模式与面向代理的技巧。它产出的是命令调用与使用指导，而非自身的文件或代码。
适用场景
当任务涉及从终端自动化 Notion 工作区时使用，例如查询数据库、创建或编辑页面、操作块、管理评论或上传文件。它也适用于多工作区配置管理和直接访问 Notion API。
运行要求
需要 notion 命令行工具（可通过 Homebrew、npm、Go 或发布版二进制文件安装），以及通过 notion auth login 或 NOTION_TOKEN 环境变量提供的 Notion 集成令牌。需要访问 Notion API 的网络连接。该技能不附带脚本，仅为说明文档。

Notion CLI

notion is a CLI for the Notion API. Single Go binary, full API coverage, dual output (pretty tables for humans, JSON for agents). Current: v0.7.0.

Install

bash
# Homebrewbrew install 4ier/tap/notion-cli
# npmnpm install -g @4ier/notion-cli
# Gogo install github.com/4ier/notion-cli@latest
# Or download a binary from https://github.com/4ier/notion-cli/releases

Auth

bash
notion auth login --with-token <<< "ntn_xxxxxxxxxxxxx"notion auth login --with-token --profile work <<< "ntn_xxx"  # named profileexport NOTION_TOKEN=ntn_xxxxxxxxxxxxx                        # env var alternativenotion auth status        # shows workspace + integration type (internal/public)notion auth switch        # interactive profile pickernotion auth switch work   # direct switchnotion auth doctor        # health check — warns if internal integration

auth status / doctor surface the integration type, so it's easy to spot when you need to share a parent page before creating workspace-root content.

Search

bash
notion search "query"                    # everythingnotion search "query" --type page        # pages onlynotion search "query" --type database    # databases only

Pages

bash
notion page view <id|url>                # render page contentnotion page list                         # list workspace pagesnotion page create <parent> --title "X" --body "content"notion page create <db-id> --db "Name=Review" "Status=Todo"  # database row
# Archive / restore (soft-delete)notion page archive <id>                 # canonicalnotion page trash <id>                   # aliasnotion page delete <id>                  # alias (legacy)notion page restore <id>                 # reverse
# Move / open / editnotion page move <id> --to <parent>notion page open <id>                    # open in browsernotion page edit <id|url>                # edit in $EDITOR (markdown round-trip)
# Properties (type-aware)notion page set <id> Key=Value ...notion page props <id>                   # show all (summary; paginated values may be truncated)notion page props <id> <prop-id>         # single raw JSON
# NEW in v0.7: paginated single-property fetch (fixes >25-item truncation)notion page property <id> <prop-id>notion page property <id> --name "References"         # resolve id by display namenotion page property <id> <prop-id> --format json
# Relationsnotion page link <id> --prop "Rel" --to <target-id>notion page unlink <id> --prop "Rel" --from <target-id>
# NEW in v0.7: server-side markdown I/O (preferred for full-page dumps)notion page markdown <id>                # print to stdoutnotion page markdown <id> --out page.md  # write to filenotion page markdown <id> --format json  # full response (truncated flag, unknown_block_ids)
notion page set-markdown <id> --file new.md           # replace whole page (default)cat new.md | notion page set-markdown <id> --file -   # stdinnotion page set-markdown <id> --append --text "\n\n> Appended"notion page set-markdown <id> --after "Status...pending" --text "Now: done"notion page set-markdown <id> --range "old...stale" --text "fresh" --allow-deleting-content

page markdown vs block list --md: prefer page markdown for whole pages — it uses the server renderer and handles toggles, columns, synced blocks, and databases-as-pages correctly. Use block list --md only when you need a single sub-block.

Databases

bash
notion db list                           # list databasesnotion db view <id>                      # show schemanotion db query <id>                     # all rowsnotion db query <id> -F 'Status=Done' -s 'Date:desc'notion db query <id> --filter-json '{"or":[...]}'notion db query <id> --allnotion db create <parent> --title "X" --props "Status:select,Date:date"notion db update <id> --title "New Name" --add-prop "Priority:select"notion db add <id> "Name=Task" "Status=Todo" "Priority=High"notion db add-bulk <id> --file items.jsonnotion db export <id>                    # CSV (default)notion db export <id> --format jsonnotion db export <id> --format md -o report.mdnotion db open <id>

Filter operators

SyntaxMeaning
=equals
!=not equals
> / >=greater than (or equal)
< / <=less than (or equal)
~=contains

Multiple -F flags combine with AND. Property types are auto-detected from schema.

Sort: -s 'Date:desc' or -s 'Name:asc'

Bulk add file format

json
[{"Name": "Task A", "Status": "Todo"}, {"Name": "Task B", "Status": "Done"}]

Blocks

bash
notion block list <parent-id>            # list child blocksnotion block list <parent-id> --allnotion block list <parent-id> --depth 3  # recursivenotion block list <parent-id> --md       # markdown; prefer 'page markdown' for pagesnotion block get <id>
# Append / insert — both handle >100 children and >2000-char code blocks automaticallynotion block append <parent> "text"notion block append <parent> "text" -t bulletnotion block append <parent> "text" -t code --lang ts        # 'ts' / 'sh' / 'yml' etc. normalizednotion block append <parent> --file notes.md                 # any length, auto-batchednotion block append <parent> --file big.md --on-oversize=truncatenotion block insert <parent> "text" --after <block-id>
# Update — now with markdown supportnotion block update <id> --text "plain new content"notion block update <id> --text "See **[docs](https://x.com)**" --markdownnotion block update <id> --file patch.md                     # must parse to exactly one block
notion block delete <id1> [id2] [id3]notion block move <id> --after <target>notion block move <id> --before <target>notion block move <id> --parent <new-parent>

Block types: paragraph/p, h1/h2/h3, bullet, numbered, todo, quote, code, callout, divider.

Media blocks (image / file / video / audio / pdf)

bash
# External URL (http/https)notion block append <page> --image-url https://example.com/a.png --caption "fig 1"
# Local file → upload + embed in one commandnotion block append <page> --image-file ./chart.png --caption "heap usage"notion block append <page> --pdf-file ./spec.pdfnotion block append <page> --video-file ./demo.mp4
# Reference an existing file_upload idnotion block append <page> --image-upload 351d45fb-... --caption "reused"

Same triple (--<kind>-url / --<kind>-file / --<kind>-upload) exists for image, file, video, audio, pdf. --caption works with any.

Comments

bash
notion comment list <page-id>notion comment add <page-id> --text "comment text"notion comment add <page-id> --text "with @mention" --mention-user <user-id>notion comment get <comment-id>notion comment reply <comment-id> "reply text"          # same thread
# NEW in v0.7notion comment update <comment-id> --text "edited text"notion comment update <comment-id> --text "with @mention" --mention-user <user-id>notion comment delete <comment-id>                      # single or manynotion comment delete <id1> <id2> <id3>                 # variadic

Users

bash
notion user me                           # current bot infonotion user list                         # all workspace usersnotion user get <user-id>

Files

bash
# List / retrieve / uploadnotion file listnotion file get <upload-id>                                # NEW in v0.7 — status / size / URLnotion file upload ./local/file.pdf                        # local pathnotion file upload https://example.com/chart.png --name chart.png   # URL sourcecurl -sSL https://host/file.zip | notion file upload - --name file.zip   # stdinnotion file upload ./image.png --to <page-id>              # upload + attach to page

Raw API (escape hatch)

bash
notion api GET /v1/users/me              # /v1/ is auto-prepended if missingnotion api GET /users/me                 # → prints 'note: prepending /v1...' and worksnotion api POST /v1/search --body '{"query":"test"}'notion api PATCH /v1/pages/<id> --body @body.json        # read body from fileecho '{"query":"x"}' | notion api POST /v1/search --body -  # explicit stdin

Output Modes

  • Terminal (TTY): colored tables, readable formatting
  • Piped / scripted: JSON automatically
  • Explicit: --format json / --format table / --format md
  • --debug: show HTTP request/response details

All output includes full Notion UUIDs. All commands accept Notion URLs or IDs.

Tips for agents

  • notion db add and notion page set auto-detect property types from schema, so Tags=a,b,c (multi_select) and Done=true (checkbox) both just work.
  • For long markdown, prefer notion page set-markdown --file over notion block append --file — server-side parsing has no 100-children limit.
  • For relation / rollup properties that may have >25 items, always use notion page property (not page view / page props).
  • Pipe to jq: notion db query <id> -F 'Status=Done' --format json | jq '.results[].id'
  • When an error looks confusing, check it for a → hint line — the CLI decorates common API errors with actionable next steps.
  • When working with an internal integration: workspace-root page creation isn't allowed — share a parent page first, then pass its id.

来源与署名

来源：4ier/notion-cli位于skills/notion-cli提交a48f66f

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多Productivity & Workflow技能

Dd Meeting Prep

anthropics

精选

为尽职调查会议（如管理层演示、专家访谈）准备问题清单、基准数据和需重点探查的风险信号。

Productivity & Workflow39K2周前更新

Dd Checklist

anthropics

精选

生成并跟踪按行业定制的尽职调查清单，涵盖各工作流、状态跟踪与红旗升级。

Productivity & Workflow39K2周前更新

Deal Tracker

anthropics

精选

跟踪进行中的并购交易，管理里程碑、截止日期、行动项和每周交易回顾。

Productivity & Workflow39K2周前更新

Client Review

anthropics

精选

为客户回顾会议准备投资组合业绩、配置分析、谈话要点和行动事项。

Productivity & Workflow39K2周前更新

Morning Note

anthropics

精选

为覆盖股票撰写简明的晨会纪要，涵盖隔夜动态、交易想法和当日关键事件。

Productivity & Workflow39K2周前更新

Notion Spec To Implementation

openai

精选

把 Notion 规格说明转化为实施计划、关联任务和进度更新。

Productivity & Workflow27K4周前更新