Notion — OpenClaw Skill

Notion API for creating and managing pages, databases, and blocks.

Productivity Vetted

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

  1. Create a Notion integration at notion.so/my-integrations
  2. Copy the API key (starts with ntn_ or secret_)
  3. Store it: mkdir -p ~/.config/notion && echo "ntn_your_key" > ~/.config/notion/api_key
  4. Set the environment variable: export NOTION_API_KEY="ntn_your_key"
  5. 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.

Manage Notion from your AI agent

Create pages, query databases, and update your workspace -- all through natural language.