notion

What This Skill Does

The Notion skill for OpenClaw provides a robust, interface-driven approach to interacting with the Notion workspace. By wrapping the official Notion API, this skill allows an AI agent to read page content, append markdown blocks, query complex databases, and manage schema structures safely. It acts as a bridge between the agent's logic and the Notion ecosystem, utilizing a local CLI (notion-cli) to ensure that all API calls are executed with authenticated, structured commands. This skill is particularly useful for agents tasked with knowledge management, project tracking, or automated reporting within Notion workspaces.

Installation

To integrate this skill into your environment, use the OpenClaw manager by executing: clawhub install openclaw/skills/skills/dimagious/notion-skill. Once installed, ensure you have generated an Internal Integration Token from the Notion developer portal. Set this token as an environment variable (NOTION_API_KEY). If you work with multiple Notion accounts, you can manage them by switching the NOTION_PROFILE variable to toggle between personal and work configurations seamlessly.

Use Cases

This skill is ideal for tasks requiring structured information management. Use it to automatically append meeting notes to specific project pages, update task statuses in a Kanban database based on recent activity, or generate summary reports from a database of entries. It is perfect for teams that want to keep their documentation live and updated without manual copy-pasting, as the agent can perform these updates in the background based on natural language triggers.

Example Prompts

1. "Find the project page for the Q4 roadmap and append a new checklist item with the updated timeline I just received via email."
2. "Query the engineering database to list all tasks with a status of 'in-progress' that were created more than two weeks ago."
3. "Create a new row in the client database using the contact information provided in the latest lead sheet I uploaded."

Tips & Limitations

Always remember that the Notion API is subject to rate limits; while the skill manages basic operations well, avoid triggering massive batch updates in short successions. Because Notion IDs are opaque, avoid hardcoding URLs in your scripts; instead, ask the agent to search for the ID first or maintain a local index file. Always review schema changes with the diff command before applying, as database structural modifications can be destructive if not handled with care. Ensure your integration token has been explicitly shared with any page or database you wish to modify, as the API remains blind to unshared content.