A powerful integration for programmatically managing Notion pages, data sources, and media uploads using the latest API specifications.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-notion-api
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 openclaw-notion-api 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 openclaw-notion-api?
The openclaw-notion-api is a specialized tool designed to bridge the gap between your local environment and the Notion ecosystem. As a key component of Openclaw Skills, it provides a robust interface for creating and updating pages, managing complex databases (now referred to as data sources), and handling block-level content.
This skill is built to support the most recent API version (2025-09-03), ensuring that developers can take advantage of advanced features like direct file uploads and the new dual-ID system for databases. By integrating this skill into your workflow, you can transform Notion from a passive note-taking app into a dynamic, automated data hub.
openclaw-notion-api Use Cases
- Automating the creation of daily logs or meeting notes directly in Notion.
- Syncing external database records with Notion data sources for real-time dashboards.
- Bulk uploading images or project documents to specific page blocks.
- Programmatically updating task statuses and project metadata across multiple pages.
- Searching and retrieving workspace content for archival or analysis purposes.
How openclaw-notion-api Works
- Authentication is established using a secure internal integration token stored in your local config.
- The skill targets specific pages or databases that have been explicitly shared with the integration.
- Requests are dispatched with the required Notion-Version headers to ensure compatibility with the 2025-09-03 API.
- Operations are performed using either database_id for creation or data_source_id for complex querying.
- Media management follows a specialized three-step lifecycle: creating an upload object, sending file content, and finally inserting the file block into a page.
openclaw-notion-api Setup
- Create an internal integration at notion.so/profile/integrations.
- Obtain your API key (it will begin with
ntn_orsecret_). - Save your key to the local configuration directory:
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
- Open the target Notion page, click the triple-dot menu, and use "Connect to" to select your integration name.
openclaw-notion-api Data Schema & Taxonomy
The openclaw-notion-api skill interacts with a wide variety of Notion property types. Below is a summary of the supported data structures:
| Property Type | JSON Structure Sample |
|---|---|
| Title | {"title": [{"text": {"content": "..."}}]} |
| Select | {"select": {"name": "Option"}} |
| Date | {"date": {"start": "2024-01-15"}} |
| Checkbox | {"checkbox": true} |
| Relation | {"relation": [{"id": "page_id"}]} |
| Rich Text | {"rich_text": [{"text": {"content": "..."}}]} |
Note that in the latest version of Openclaw Skills for Notion, databases utilize a data_source_id for queries and a database_id for page parent references.
openclaw-notion-api Advanced Features
- Direct File Ingestion: Supports multipart/form-data uploads for files and images up to 20MB without external hosting.
- Data Source Querying: Advanced filtering and sorting capabilities using the new
/data_sources/endpoints. - Multi-Block Insertion: Append multiple block types (paragraphs, images, files) in a single PATCH request.
- Version-Specific Optimization: Native support for the 2025-09-03 API, handling the transition from legacy database objects to modern data sources.
- Rate Limit Handling: Optimized for standard API throughput of approximately 3 requests per second.
SKILL.md
Loading
Related Openclaw Skills
Daily Oracle
A local-only background agent that generates daily life predictions by analyzing your calendar, messages, and social signals.
Zhihu Content Publisher
An automated tool to publish articles and thoughts on Zhihu using Chrome Browser Relay for seamless browser control.
Feishu IM Tool
A powerful tool for AI agents to interact with Feishu IM, enabling automated messaging and media sharing via the Feishu Bot API.
Self-Reflection & Post-Mortem
A structured framework for AI agents to evaluate project performance, document technical growth, and analyze problem-solving workflows.
Prompt Engineer
An advanced engineering skill for designing, optimizing, and diagnosing system prompts for autonomous agents and advisory AI using a three-layer architecture.
Web to Obsidian Content Capture
A seamless utility for scraping web content, performing high-quality translations, and importing formatted Markdown files directly into an Obsidian vault.
Featured*
