A JSON-first CLI skill for managing Notion pages, databases, and Markdown content with deterministic script execution.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-api-automation
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-api-automation 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 Management Skill?
This Openclaw Skills integration provides a robust interface for interacting with the Notion API using a deterministic CLI approach. By prioritizing structured scripts over ad-hoc API calls, the skill ensures lower error rates, automated handling of pagination, and respect for Notion's specific rate limits. It is designed to allow AI agents to reliably parse and reason about Notion data, providing a clean JSON output for every operation.
Whether you are organizing a complex workspace or building an automated documentation pipeline, this skill bridges the gap between your local environment and the Notion cloud. It supports the latest API standards and offers a predictable interface for search, read, write, and move operations, making it an essential component for any developer using Openclaw Skills to enhance their productivity.
Notion Management Skill Use Cases
- Capturing meeting notes or quick ideas directly into a designated Notion inbox.
- Exporting existing Notion pages as Markdown for local processing, backups, or cross-platform documentation.
- Organizing workspaces by moving pages between different databases or parent pages.
- Automating the triage of an inbox page using pre-defined JSON logic rules.
- Appending updates to project logs or shared documents without manually opening the browser.
How Notion Management Skill Works
- The AI agent invokes the notionctl.mjs entrypoint with specific commands such as search, export-md, or create-md.
- The skill validates the NOTION_API_KEY and ensures the request uses the required Notion-Version: 2025-09-03 header.
- For search queries, the CLI identifies page or data source IDs, allowing the agent to locate specific content within the workspace hierarchy.
- Content operations convert between Notion's block-based structure and standard Markdown for seamless reading and writing.
- The skill manages API rate limits (averaging 3 requests per second) and handles HTTP 429 retries automatically.
- All results are returned as structured JSON, enabling the agent to confirm success or plan subsequent actions based on the returned data.
Notion Management Skill Setup
To get started with this skill in your Openclaw Skills environment, ensure you have Node.js installed and your API credentials configured.
# Set your Notion API Key
export NOTION_API_KEY='your_integration_token'
# Run a sanity check to verify connection
node {baseDir}/scripts/notionctl.mjs whoami
Ensure that you have shared your Notion integration with the specific pages or databases you want the agent to access.
Notion Management Skill Data Schema & Taxonomy
The skill organizes interaction through a set of distinct identifiers and content types:
| Attribute | Description |
|---|---|
| Page ID | Unique identifier or URL for an individual Notion page. |
| Data Source ID | Specifically used for database containers (required for move operations). |
| Markdown Body | The primary format for reading from and writing to page content. |
| Property Set | Key-value pairs (e.g., Status, Tags, Due) used when interacting with database rows. |
| Triage Rules | A JSON schema used to define how pages should be moved based on their properties or titles. |
Notion Management Skill Advanced Features
- Rule-based triage system for bulk-organizing pages using custom JSON logic.
- Dry-run mode for move and triage operations to prevent accidental data restructuring.
- JSON-first architecture optimized for high-reliability AI agent interactions within Openclaw Skills.
- Support for custom metadata tagging when creating database entries.
- Automatic conversion of Notion blocks into clean, portable Markdown files.
SKILL.md
Loading
Related Openclaw Skills
iOS Simulator Automation
An advanced CLI wrapper that enables AI agents to programmatically control iOS simulators, manage app lifecycles, and perform accessibility-based UI navigation.
Fabric API Skill
A cross-platform skill for Openclaw Skills that enables AI agents to create, search, and organize content within a Fabric workspace using the official HTTP API.
Mistral OCR PDF Extraction
A powerful tool for converting complex PDFs and scanned documents into structured Markdown and JSON using the Mistral OCR API.
App Store Readiness Audit
An automated compliance auditor for iOS repositories ensuring App Store and TestFlight readiness.
Reddit Readonly
A specialized tool for searching subreddits and extracting comment threads via public JSON endpoints without requiring authenticated API access.
Todoist API Skill
A comprehensive CLI and automation toolkit for managing Todoist tasks, projects, and workflows via the Todoist API v1.
Featured*
