Notion Pro
Skill by baixiaodev
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/baixiaodev/notion-proname: notion-pro description: Complete Notion API skill with Python CLI tool — auto-pagination, recursive blocks, 429 retry, and agent operation strategies. version: 1.0.1 homepage: https://github.com/baixiaodev/notion-pro-skill metadata: {"clawdbot":{"emoji":"📝"}} env:
- NOTION_API_KEY: Notion integration API key (or configure in openclaw.json → skills.entries.notion-pro.apiKey)
Notion Pro — Complete Notion API Skill for OpenClaw
A production-grade Notion API skill with a built-in Python CLI tool. Unlike basic Notion skills that only provide command syntax, this skill includes agent operation strategies, automatic pagination, recursive block fetching, 429 rate-limit retry, and comprehensive API reference — everything an AI agent needs to operate Notion effectively.
What Makes This Different
| Capability | This Skill | Basic Skills |
|---|---|---|
| Agent operation strategy (5-step workflow) | ✅ | ❌ |
Recursive block fetching (--recursive, 5 levels) | ✅ | ❌ |
Auto-pagination (--all) | ✅ | ❌ |
| 429 rate-limit auto-retry (Retry-After) | ✅ | ❌ |
Positional insert (--after) | ✅ | ❌ |
| API limits quick reference | ✅ Complete | Partial |
| 4 operation pattern SOPs | ✅ | ❌ |
| Zero dependencies (stdlib only) | ✅ Python 3 | Node.js / curl |
Setup
- Create a Notion Integration and copy the API key
- Configure the key via one of:
- Environment variable:
export NOTION_API_KEY="ntn_xxxxx" - OpenClaw config:
openclaw.json→skills.entries.notion-pro.apiKey
- Environment variable:
- Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)
- If a page/database isn't found via search, it likely hasn't been shared with the integration yet
Tool: notion_api.py
All Notion operations must go through this script — do not use curl directly.
Script path: scripts/notion_api.py (relative to this skill's directory)
# The script auto-detects its own location. Usage:
python3 <SKILL_DIR>/scripts/notion_api.py <command> [options]
Agent Operation Strategy (Must Read)
Task Planning Workflow
Follow this sequence for any Notion task:
- Discover — Use
searchto find the target page/database ID - Inspect — Use
get-pageorget-blocksto understand current structure - Plan — Determine the operation sequence (create/update/append/delete)
- Execute — Execute in batches, ≤50 blocks per batch (safety margin)
- Verify — After critical operations, use
get-blocksto verify results
Read Strategy
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-baixiaodev-notion-pro": {
"enabled": true,
"auto_update": true
}
}
}