notion

The Notion skill enables your OpenClaw assistant to interface directly with the Notion platform, transforming your workspace into a programmable data hub. This skill provides a bridge between AI-driven intelligence and your structured personal or team data, allowing for automated content generation, database item management, and complex information retrieval. It is designed for power users, researchers, and project managers who rely on Notion for documenting workflows, maintaining task lists, or storing evolving knowledge bases.

• Full integration with the Notion API (v1, version 2025-09-03) to read, update, and create pages and blocks.

• Support for advanced data management, including querying databases (data sources), sorting results, and applying specific property filters.

• Capabilities to modify page content, such as appending rich text, paragraph blocks, or structured database entries.

• Capability to handle diverse Notion property types including Titles, Rich Text, Select, Multi-select, Date ranges, Checkboxes, Numbers, and Relations.

• Seamless identification of database schemas using the latest Notion API conventions where databases are treated as data sources.

• Ensure you have a registered Notion integration with the correct API secret (starting with ntn_ or secret_) stored in your local configuration directory.

• You must explicitly share target pages or databases with your integration via the Notion UI (Connect to) for the agent to have access.

• Respect the Notion API rate limits of approximately 3 requests per second; the agent handles 429 rate_limited responses using standard retry logic.

• Note that complex UI-only features like saved database view filters cannot be modified via the API; focus on data-centric operations.

• When creating data sources, use the is_inline parameter to embed them directly into existing pages for better organizational hierarchy.

• The API uses UUIDs for page and block identification; ensure correct IDs are provided for read/patch operations.

• This skill requires consistent use of the 2025-09-03 API version header to ensure compatibility with modern data source structures.