A specialized skill for operating the Notion Public API through a curated OpenAPI schema to handle complex block traversal and structured data writes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-openapi-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install notion-openapi-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is notion-openapi-skill?
The notion-openapi-skill is a robust extension for Openclaw Skills designed to bridge the gap where standard MCP implementations fall short. It leverages the uxc skill to provide a developer-centric interface for the Notion Public API, focusing on high-fidelity operations like recursive block traversal, data source inspection, and precise content updates.
By utilizing a curated OpenAPI schema, this skill allows AI agents and developers to interact with Notion's workspace as a structured data environment. It is particularly effective for tasks requiring deep page nesting analysis or managing complex database schemas that require more than simple CRUD operations.
notion-openapi-skill Use Cases
- Performing recursive reads of deeply nested Notion page structures and block trees.
- Executing structured writes and page creations that require specific Notion-Version headers.
- Inspecting and querying Notion data sources and legacy databases for schema discovery.
- Automating workspace maintenance tasks like trashing or restoring pages using the in_trash semantics.
- Synchronizing external data into Notion blocks with high precision via CLI-driven operations.
How notion-openapi-skill Works
- The skill initializes by linking to the Notion Public API endpoint using a curated OpenAPI schema.
- Authentication is handled via uxc using either internal integration tokens or OAuth credentials with specific version headers.
- Search operations are performed to identify target page IDs, database IDs, or block IDs within the workspace.
- For deep content analysis, the skill executes paginated requests to retrieve child blocks, identifying nested children for recursive traversal.
- Content modifications are processed through validated JSON payloads, supporting page updates and block appending.
- The skill returns structured JSON envelopes, allowing for automated parsing of successful data or error states.
notion-openapi-skill Setup
First, ensure uxc is installed, then link the Notion OpenAPI schema:
uxc link notion-openapi-cli https://api.notion.com/v1 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/notion-openapi-skill/references/notion-public.openapi.json
Configure your credentials using a Notion internal integration token:
uxc auth credential set notion-openapi \
--auth-type api_key \
--header "Authorization=Bearer {{secret}}" \
--header "Notion-Version=2026-03-11" \
--secret-env NOTION_API_TOKEN
uxc auth binding add \
--id notion-openapi \
--host api.notion.com \
--path-prefix /v1 \
--scheme https \
--credential notion-openapi \
--priority 100
notion-openapi-skill Data Schema & Taxonomy
The skill organizes data interactions based on the Notion object model. Key entities include:
| Object Type | Primary Operations | Metadata Tracked |
|---|---|---|
| Pages | Create, Update, Retrieve | page_id, properties, in_trash |
| Blocks | Append, Update, Delete | block_id, has_children, type |
| Data Sources | Query, Retrieve | data_source_id, schema, properties |
| Users | Retrieve | user_id, workspace identity |
All responses follow the Openclaw Skills standard envelope containing ok, kind, protocol, and data fields.
notion-openapi-skill Advanced Features
- Multi-level nested block support: Allows appending up to two levels of nested blocks in a single payload.
- Shared Credential Interop: Ability to share OAuth credentials with other tools like notion-mcp for seamless workspace access.
- Recursive Traversal Logic: Designed for external loop control to navigate infinite block depth.
- Modern Trash Semantics: Fully supports the 2026-03-11 versioning for trash and restore workflows.
- Schema Discovery: Dedicated endpoints for inspecting data source structures before executing property-sensitive queries.
SKILL.md
Loading
Related Openclaw Skills
ClawHub Ops
A comprehensive operational framework for managing Openclaw Skills lifecycle, including automated publishing, multi-account handling, and SEO ranking strategies.
t2i (Text-to-Image Placeholder)
A specialized placeholder skill designed to manage and transition text-to-image generation workflows on skills.video.
Arrow
A high-performance reference skill for mastering the Apache Arrow in-memory columnar format and zero-copy data exchange.
Trade Show Budget Planner
A professional financial modeling tool for building trade show budgets, calculating ROI projections, and determining investment feasibility.
Signup & Login Page Generator
A professional framework for building high-converting, SEO-optimized signup and login pages with integrated discount and verification flows.
Skill Creator
Skill Creator is a professional-grade development framework for designing, benchmarking, and iteratively refining AI agent capabilities.
Featured*
