菜单
Manage Notion pages, databases, and blocks via the Notion API using curl. Use when user wants to create/read/update Notion pages, query databases, add content blocks, or search the Notion workspace.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | notion |
| description | Manage Notion pages, databases, and blocks via the Notion API using curl. Use when user wants to create/read/update Notion pages, query databases, add content blocks, or search the Notion workspace. |
| allowed-tools | ["Bash","Read","Write"] |
| model | haiku |
| user-invocable | true |
| when_to_use | When user wants to interact with Notion workspace content. Triggers: "create Notion page", "add to Notion", "query Notion database", "search Notion", "update Notion page", "read Notion page", "list Notion pages". |
| argument-hint | <action: search|create|read|update|query|append> <details> |
Interact with Notion via the REST API using curl. No separate CLI install needed.
No install needed beyond curl (pre-installed on macOS/Linux).
Set up credentials:
export NOTION_API_KEY="secret_xxxxxxxxxxxx"
Get your key:
Store in shell profile or in 1Password and inject via op run.
Base URL: https://api.notion.com/v1
Headers:
Authorization: Bearer $NOTION_API_KEY
Notion-Version: 2022-06-28
Content-Type: application/json
curl -s -X POST "https://api.notion.com/v1/search" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{"query": "<search term>"}' | jq '.results[] | {id: .id, title: .properties.title.title[0].plain_text}'
# Read a page
curl -s "https://api.notion.com/v1/pages/<PAGE_ID>" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28"
# Create a page
curl -s -X POST "https://api.notion.com/v1/pages" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{
"parent": {"page_id": "<PARENT_PAGE_ID>"},
"properties": {
"title": {"title": [{"text": {"content": "<Page Title>"}}]}
}
}'
# Update page title
curl -s -X PATCH "https://api.notion.com/v1/pages/<PAGE_ID>" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{"properties": {"title": {"title": [{"text": {"content": "<New Title>"}}]}}}'
# Read page blocks
curl -s "https://api.notion.com/v1/blocks/<PAGE_ID>/children" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" | jq '.results[] | {type: .type, text: .paragraph.rich_text[0].plain_text}'
# Append a paragraph block
curl -s -X PATCH "https://api.notion.com/v1/blocks/<PAGE_ID>/children" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{
"children": [{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [{"type": "text", "text": {"content": "<Your text here>"}}]
}
}]
}'
# Query a database
curl -s -X POST "https://api.notion.com/v1/databases/<DB_ID>/query" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{}' | jq '.results[] | .properties'
# Query with filter
curl -s -X POST "https://api.notion.com/v1/databases/<DB_ID>/query" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{"filter": {"property": "Status", "select": {"equals": "In Progress"}}}'
Search for a page:
curl -s -X POST "https://api.notion.com/v1/search" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{"query": "meeting notes march"}' | jq '.results[0] | {id, url}'
Create a new note under a parent page: Set PARENT_ID to your workspace page ID, then:
curl -s -X POST "https://api.notion.com/v1/pages" \
-H "Authorization: Bearer $NOTION_API_KEY" \
-H "Notion-Version: 2022-06-28" \
-H "Content-Type: application/json" \
-d '{"parent": {"page_id": "'$PARENT_ID'"}, "properties": {"title": {"title": [{"text": {"content": "My New Note"}}]}}}'
NOTION_API_KEY is set: [ -z "$NOTION_API_KEY" ] && echo "Not set"jq; install with brew install jq if neededworkspace/notion-<page-id>.md rather than displaying rawCreate algorithm-optimized social media content (Threads, Instagram, etc.) from a topic or trend. Uses Meta's patent-based scoring (5 dimensions) to maximize reach. Optionally generates NotebookLM image cards. Use when user says "create a post about", "write content for", "make a post", "turn this into a post".
Manage macOS Apple Notes via the memo CLI — create, view, edit, delete, search, move, and export notes across folders. Use when user says "add note", "find note", "show my notes", "create note about...", or "export note".
Manage macOS Apple Reminders via the remindctl CLI — list, add, edit, complete, and delete reminders across all reminder lists. Use when user says "remind me", "add to reminders", "show my reminders", "mark reminder done", or "delete reminder".
Create, search, and manage Bear notes via the grizzly CLI. Use when user says "add a bear note", "search bear notes", "list my notes in bear", "open bear note about X".
Structured brainstorming with multiple perspectives. Use when user says "brainstorm about", "ideas for", "help me think about", "suggestions for".
Capture frames or short clips from RTSP/ONVIF network cameras or local webcams using ffmpeg or camsnap. Use when user says "take a snapshot from camera", "capture front door", "grab a frame from the security cam", or any camera capture request involving IP cameras or webcams.