Notion — OpenClaw Skill
Notion API for creating and managing pages, databases, and blocks.
What This Skill Does
The Notion skill connects your OpenClaw agent to the Notion API, giving it the ability to create, read, update, and search across your entire Notion workspace. Your agent can search for pages and databases, create new pages with rich content blocks, query database entries with filters and sorts, update page properties, append content to existing pages, and create new databases with custom property schemas.
This skill uses the latest Notion API version (2025-09-03), which includes the new "data sources" API for enhanced database querying. The agent handles all the complexity of the Notion API -- property types, block structures, pagination -- so you can interact with your workspace using plain English. Ask the agent to add a row to your CRM, update a project status, or generate a meeting notes page, and it constructs the correct API calls automatically.
The skill respects Notion's permission model: it can only access pages and databases that have been explicitly shared with your integration. This means you control exactly what content your agent can see and modify, making it safe for workspaces that contain sensitive information.
Example Prompts
Create a new page in my "Meeting Notes" database with the title "Q2 Planning Review", date set to today, and attendees tagged as Sarah, Mike, and Priya
Query my project tracker database and show me all items where Status is "In Progress" sorted by due date
Search my Notion workspace for anything related to "onboarding checklist" and summarize what you find
Add a new section to our product roadmap page with a heading "Q3 Priorities" followed by a bulleted list of the features we discussed
Update the status of "Website Redesign" in my project tracker from "In Progress" to "Done" and add a comment with the launch date
Create a new database called "Content Calendar" under the Marketing page with columns for Title, Status (Draft/Review/Published), Author, and Publish Date
Pull all entries from my "Leads" database where Source is "Inbound" and created in the last 30 days, then format them as a summary table
Requirements
Environment variable: NOTION_API_KEY (starts with ntn_ or secret_)
- Integration: Create one at notion.so/my-integrations
- Page sharing: Share target pages/databases with your integration (click "..." then "Connect to" then your integration name)
- API version: Uses Notion API 2025-09-03 (latest)
Setup on KiwiClaw
This skill is pre-installed and configured on all KiwiClaw plans. Add your Notion API key in the KiwiClaw dashboard settings, share your Notion pages with the integration, and your agent can immediately start managing your workspace. No manual configuration needed.
Setup Self-Hosted
- Create a Notion integration at notion.so/my-integrations
- Copy the API key (starts with
ntn_orsecret_) - Store it:
mkdir -p ~/.config/notion && echo "ntn_your_key" > ~/.config/notion/api_key - Set the environment variable:
export NOTION_API_KEY="ntn_your_key" - Share your target pages and databases with the integration in Notion
Related Skills
- Obsidian -- local-first alternative for knowledge management
- Trello -- lightweight project boards for task management
- Slack -- capture Slack discussions as Notion pages
- GitHub -- sync GitHub issues with Notion project trackers
FAQ
What can the Notion skill do in OpenClaw?
The Notion skill lets your OpenClaw agent search for pages and databases, create new pages with rich content, query and filter database entries, update page properties, add content blocks, and manage your entire Notion workspace through natural language.
Does the Notion skill require an API key?
Yes. You need a Notion integration API key (starts with ntn_ or secret_). Create one at notion.so/my-integrations, then share your target pages and databases with the integration. On KiwiClaw, you add the key once in the dashboard.
Can the Notion skill access all my Notion pages?
The skill can only access pages and databases that have been explicitly shared with your Notion integration. This is a security feature -- you control exactly which content the agent can read and modify.
Does the Notion skill support the latest Notion API version?
Yes. The skill uses Notion API version 2025-09-03, the latest version. This includes support for the new data sources API, which provides enhanced database querying capabilities.