A powerful integration that enables AI agents to interact with Notion pages and databases using the official API and local CLI tools.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-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-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?
This skill empowers your AI agent to bridge the gap between code and documentation. By leveraging the official Notion API through a local CLI interface, agents can read, write, and manage content within your workspace. It provides a structured way to handle both unstructured page data and relational database entries, making it an essential part of the Openclaw Skills ecosystem for knowledge management.
Designed for safety and flexibility, the skill supports multiple profiles and emphasizes non-destructive operations like appending blocks and updating properties. Whether you are building an automated task tracker or a documentation assistant, this skill provides the necessary primitives for robust Notion integration.
Notion Use Cases
- Automating the creation of meeting notes or project updates directly from terminal workflows.
- Querying complex databases to extract specific tasks, records, or status updates.
- Appending progress logs or research findings to existing project pages without overwriting content.
- Programmatically updating database properties based on external triggers or code execution results.
- Synchronizing local data structures with Notion database schemas for consistent documentation.
How Notion Works
- The agent initializes the session using a secure Notion Internal Integration Token stored in the environment.
- Operations are routed through a local CLI (notion-cli), which handles the communication with the official Notion API.
- The skill identifies specific page or database IDs to perform granular actions like reading content or querying records.
- For database interactions, the skill can inspect schemas and apply diff-based changes to ensure data integrity.
- The agent follows a safety-first approach, prioritizing block appending over full page rewrites to preserve existing data.
Notion Setup
- Create a Notion Integration at the official developer portal (https://www.notion.so/my-integrations).
- Obtain your Internal Integration Token and ensure the integration is shared with the specific pages or databases you need to access.
- Install the required CLI tools (notion-cli for Node.js or notion-cli-py for Python).
- Configure your environment variables:
export NOTION_API_KEY=secret_your_token_here
export NOTION_PROFILE=personal
Notion Data Schema & Taxonomy
| Component | Data Type | Description |
|---|---|---|
| Page ID | String | The unique, opaque identifier for a specific Notion page. |
| Database ID | String | The unique identifier for a Notion database used for queries and row creation. |
| Block Content | Markdown | Text or structured data used when appending content to pages. |
| DB Filter | JSON | Logical conditions used to filter results during a database query. |
| DB Schema | JSON | The structural definition of properties, types, and relations within a database. |
Notion Advanced Features
- Multi-profile support (e.g., personal vs. work) allowing the agent to switch contexts via the NOTION_PROFILE variable.
- Declarative schema management using diff and apply commands to evolve database structures safely.
- Advanced database querying with full support for JSON-based filters and sorting logic.
- High-performance block appending to minimize API overhead and maintain page history.
- Built-in safety protocols that require explicit confirmation before applying destructive schema changes.
- Seamless integration within the Openclaw Skills framework for multi-agent collaboration.
SKILL.md
Loading
Related Openclaw Skills
n8n Automation
A powerful skill to manage n8n workflows, executions, and triggers directly through the n8n REST API.
Tube Summary
A powerful tool that searches YouTube for relevant videos and generates detailed textual summaries by analyzing video subtitles.
MolTunes
MolTunes is a decentralized marketplace where AI agents can publish, discover, and install skills while earning MOLT tokens through a secure, cryptographic economy.
ComfyUI Local Image Generation
A local image generation skill for Openclaw Skills that enables private, high-performance visual creation using ComfyUI workflows.
ADI Decision Engine
A sophisticated multi-criteria decision analysis engine for ranking options based on weighted scoring, constraints, and explainable logic.
Science Simulation Author
Transform YAML or JSON specifications into fully interactive, offline-ready STEM simulations with integrated inquiry worksheets.
Featured*
