A comprehensive tool for programmatically managing Notion pages, data sources, and content blocks via the Notion API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion
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 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 API Integration?
The Notion skill provides a robust interface for AI agents and developers to interact with the Notion workspace. By integrating this skill into your Openclaw Skills library, you can automate the entire lifecycle of documents and databases. It is specifically designed to work with the latest 2025-09-03 API version, ensuring compatibility with the modern transition from traditional databases to data sources.
This skill bridges the gap between raw data and organized knowledge management. It allows for the dynamic creation of pages, the querying of complex data sources with specific filters, and the precise modification of page content at the block level. Whether you are syncing external data or building a custom CMS, this skill provides the technical foundation needed for seamless Notion automation.
Notion API Integration Use Cases
- Automatically generating meeting summaries or project briefs from external triggers.
- Synchronizing task lists between development environments and Notion data sources.
- Appending logs, research snippets, or automated reports to specific page blocks.
- Querying databases to extract and process structured information for AI analysis.
How Notion API Integration Works
- The skill authenticates with the Notion API using a securely stored Internal Integration Token.
- It targets specific pages or databases that have been explicitly shared with the integration.
- Utilizing RESTful endpoints, the skill translates user commands into JSON payloads for creating or updating resources.
- It manages the distinction between database_id (for page creation) and data_source_id (for querying) as required by the latest API standards.
- The skill processes the response from Notion to confirm successful updates or retrieve requested data, respecting a rate limit of approximately 3 requests per second.
Notion API Integration Setup
To configure this skill within your Openclaw Skills setup, follow these steps:
- Create a new integration at notion.so/my-integrations.
- Copy your API key (the secret token starting with
ntn_orsecret_). - Store the key in your local configuration directory:
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
- In the Notion UI, navigate to the pages or databases you wish to manage, click the '...' menu, select 'Connect to', and choose your integration name.
Notion API Integration Data Schema & Taxonomy
The skill organizes data based on the Notion object model, specifically optimized for the 2025-09-03 version update.
| Object Type | Key Identifier | Usage |
|---|---|---|
| Page | page_id |
Used for retrieving content or updating page-level properties. |
| Data Source | data_source_id |
The primary identifier for querying and listing database contents. |
| Database | database_id |
Required when setting a database as a parent for new pages. |
| Block | block_id |
Used to target specific content elements for updates or deletions. |
Supported property types include Title, Rich Text, Select, Multi-select, Date, Checkbox, Number, URL, and Relation mappings.
Notion API Integration Advanced Features
- Version 2025-09-03 Support: Fully optimized for the modern transition to data sources and dual ID management.
- Granular Block Control: Ability to append nested children (paragraphs, headings, etc.) to any existing page or block.
- Advanced Querying: Support for complex property filters and multi-level sorting within data sources.
- Inline Data Sources: Capability to create embedded databases within pages using the
is_inlineattribute. - Flexible Property Formatting: Handles complex JSON structures for various Notion property types like relations and multi-selects.
SKILL.md
Loading
Related Openclaw Skills
Native App Performance Profiling
A CLI-first approach to profiling macOS and iOS application performance using xctrace and automated symbolication scripts.
nano-pdf
A command-line utility that enables PDF page editing through natural language instructions.
Nano Banana Pro
A high-performance AI tool for generating and editing images using the Google Gemini 3 Pro Image API.
Model Usage
A Python-based utility to parse CodexBar CLI data and summarize costs by specific AI models for granular budget tracking.
Obsidian
A powerful automation interface for Obsidian vaults that enables seamless note management and refactoring via CLI.
OpenAI Image Gen
Batch-generate AI images using OpenAI with automated prompt sampling and a built-in HTML gallery.
Featured*
