notion

What This Skill Does

The notioncli skill provides an interface for the OpenClaw AI agent to interact directly with the Notion API. It abstracts the complexity of Notion's REST API into simple, command-line operations, allowing for automated management of databases, pages, and blocks. By using auto-discovered database aliases, the agent can perform CRUD operations across your entire workspace without ever needing to track raw UUIDs, making it a robust integration for task tracking, CRM management, and automated documentation workflows.

Installation

To enable this skill, run the installation command provided by OpenClaw: clawhub install openclaw/skills/skills/jordancoin/notioncli

Once installed, you must authenticate your workspace. Run notion init --key $NOTION_API_KEY to configure the integration. Ensure that your Notion API key has the necessary permissions and that you have explicitly shared your target databases with your integration via the Notion interface (••• menu > Connections > Add your integration).

Use Cases

• Project Management: Automatically add tasks to a 'Tasks' database from meeting transcripts.
• Content Pipeline: Query a 'Content Calendar' database to fetch pending articles and update their status upon completion.
• CRM/Lead Gen: Sync contact information or sales notes directly into a Notion database based on incoming emails or chat logs.
• Automated Reporting: Extract data from your Notion workspace to generate daily or weekly summaries in alternative formats like CSV or JSON.

Example Prompts

1. "Find all tasks in the 'Tasks' database with a status of 'Urgent' and summarize them for me."
2. "Add a new entry to the 'Projects' database named 'Q3 Planning' with a priority set to 'High'."
3. "Update the page 'Client Outreach' in the 'CRM' database to set the 'Follow-up' status to 'Complete'."

Tips & Limitations

• Alias Management: Use the notion dbs command regularly to check if new databases have been linked. Use notion alias add to create custom, memorable names for your databases.
• Property Matching: Note that property names are case-insensitive, but they must match the database schema exactly. If a property is missing, the command will error.
• Safety Note: This tool modifies live workspace data. Always verify the results of query filters before applying mass updates to ensure you are modifying the correct pages.