Notion — 笔记协作管理

This skill lets the agent work with Notion pages and databases using the official Notion API.

The skill is declarative: it documents safe, recommended operations and assumes a local CLI (notion-cli) that actually performs API calls.

Authentication

• 创建 Notion Integration 在 https://www.notion.所以/my-integrations
• 复制 Internal Integration 令牌.
• 导出 作为:

export NOTION_API_KEY=secret_xxx

Share the integration with the pages or databases you want to access. Unshared content is invisible to the API.

Profiles (personal / work)

You may define multiple profiles (e.g. personal, work) via env or config.

Default profile: personal

Override via:

export NOTION_PROFILE=work

Pages

读取 page:

notion-cli page get 

Append blocks:

notion-cli block append  --markdown "..."

Prefer appending over rewriting content.

创建 page:

notion-cli page create --parent  --title "..."

Databases

Inspect schema:

notion-cli db get 

查询 数据库:

notion-cli db query  --filter  --sort 

创建 行:

notion-cli page create --database  --props 

更新 行:

notion-cli page update  --props 

Schema changes (advanced)

Always inspect diffs before applying schema changes.

Never modify database schema without explicit confirmation.

Recommended flow:

notion-cli db schema diff  --desired 
notion-cli db schema apply  --desired 

Safety notes

• Notion API rate-limited; batch carefully.
• Prefer append 和 updates 在...上 destructive operations.
• IDs opaque; store them explicitly, 做 不 infer 从 URLs.