AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Notion

skill-ericwang915-pythonclaw-notion · by ericwang915

Notion API for creating and managing pages, databases, and blocks. Use when: user asks to create a Notion page, query a database, search notes, add content to Notion, or manage Notion workspace items. NOT for: local file editing (use read_file/write_file), Obsidian vaults (use obsidian skill), or real-time collaboration.

↗ Website ↗ Repository
— No reviews yet
0 installs
12 views
0.0% view→install

Install

$ agentstack add skill-ericwang915-pythonclaw-notion

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Notion? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Notion

Use the Notion API to create, read, and update pages, databases, and blocks.

When to Use

  • "Create a Notion page with my meeting notes"
  • "Search my Notion for project plans"
  • "Add an item to my Notion database"
  • "Query my Notion task tracker"
  • "Update the status of this Notion page"

When NOT to Use

  • Local Markdown files: use readfile / writefile directly
  • Obsidian vaults: use obsidian skill
  • Trello boards: use trello skill
  • Google Docs: use google_workspace skill

Setup

  1. Create an integration at https://notion.so/my-integrations
  2. Copy the API key (starts with ntn or secret)
  3. Configure in pythonclaw.json:
"skills": {
  "notion": {
    "token": "ntn_your_key_here"
  }
}
  1. Share target pages/databases with your integration

Commands

Search pages

python {skill_path}/notion_api.py search "query text"

Get a page

python {skill_path}/notion_api.py get-page

Get page content (blocks)

python {skill_path}/notion_api.py get-blocks

Create a page in a database

python {skill_path}/notion_api.py create-page --database  --title "New Item" --props '{"Status": "Todo"}'

Query a database

python {skill_path}/notion_api.py query-db

Update page properties

python {skill_path}/notion_api.py update-page  --props '{"Status": "Done"}'

Append blocks to a page

python {skill_path}/notion_api.py append-blocks  --text "New paragraph content"

Notes

  • Page/database IDs are UUIDs (with or without dashes)
  • The API cannot set database view filters (UI-only)
  • Rate limit: ~3 requests/second average
  • The Notion-Version header is required for direct API calls

Resources

| File | Description | |------|-------------| | notion_api.py | Notion REST API client |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Databases