notion

What This Skill Does

The Notion skill for OpenClaw provides a powerful, JSON-first CLI interface for interacting with the Notion API. By wrapping API complexity into a deterministic script (notionctl.mjs), it ensures that every interaction adheres to strict API versioning (2025-09-03) and handles critical concerns like pagination and rate limiting (3 requests/second) gracefully. This skill allows agents to search, read, write, append, and restructure Notion content through a standardized command set, making it the primary bridge between OpenClaw and your organizational knowledge base.

Installation

To add this capability to your agent, run the installation command: clawhub install openclaw/skills/skills/tristanmanchester/notion-api-automation

Ensure that you have set the NOTION_API_KEY in your environment variables. The skill will automatically detect this key, or fall back to standard local development locations like ~/.config/notion/api_key if required.

Use Cases

• Automated Capture: Programmatically shunt notes, meeting summaries, or chat logs directly into an Inbox database with specific metadata tags.
• Knowledge Refactoring: Move pages between parent pages or into specific databases to keep workspaces organized without manual effort.
• Data Export: Extract page content as clean Markdown for inclusion in reports, LLM prompts, or other documentation tools.
• Inbox Triage: Scan existing databases, append notes to pending tasks, or update page properties like statuses and dates based on external event triggers.

Example Prompts

1. "Search for the meeting notes page titled 'Q3 Planning' and append a summary of today's meeting action items to the bottom."
2. "Move the page 'Project Specs' from my general folder into the 'Technical Documentation' database and set the status to 'Active'."
3. "Create a new note in my 'Inbox' database titled 'Research Idea' with the content: # Research Idea - [ ] Look up the new API documentation."

Tips & Limitations

• Rate Limiting: If you are running high-volume batch updates, be aware of the 3 requests/second limit; the script handles 429 errors, but it is best to avoid massive concurrent updates.
• Data Source vs. Database: Always refer to containers as data_source_id when moving pages into databases to prevent schema errors.
• Determinism: Because this skill uses a CLI, it is highly predictable and ideal for OpenClaw allowlists. Treat your Notion credentials with care, as the agent can perform full CRUD operations on any page the token has access to.