notion-cli

What This Skill Does

The notion-cli skill provides a comprehensive interface for OpenClaw to interact directly with the Notion API. It acts as a bridge between your automated workflows and your workspace, enabling programmatic control over pages, databases, and block structures. Whether you need to sync documentation, track project updates, or query specific database entries, this tool handles the heavy lifting of API communication, allowing you to manage your knowledge base without manually clicking through the Notion UI.

Installation

To integrate this skill into your environment, use the OpenClaw hub CLI: clawhub install openclaw/skills/skills/willykinfoussia/notion-cli

Before executing commands, you must configure your integration. First, create a new internal integration at https://notion.so/my-integrations to obtain your API key (starting with 'ntn_' or 'secret_'). Store this securely in your environment by creating a file at ~/.config/notion/api_key containing your token. Finally, ensure that your chosen pages or databases are shared with the integration by clicking the '...' menu in the top right of the Notion page and selecting 'Connect to' your integration name.

Use Cases

This skill is ideal for power users and developers aiming to automate administrative tasks. Common use cases include:

• Automated Reporting: Periodically updating database statuses based on external triggers.
• Content Management: Programmatically creating task pages in a project database from Jira or GitHub issues.
• Knowledge Retrieval: Fetching page content to provide context for AI agents or generating summaries.
• Database Synchronization: Querying specific database filtered views (e.g., fetching all 'Active' tasks) for follow-up actions.

Example Prompts

1. "Search for the project database titled 'Q1 Roadmap' and return all items with a status of 'Active'."
2. "Retrieve the contents of the page with ID 550e8400-e29b-41d4-a716-446655440000 and provide a summary of the current status and priority fields."
3. "Update the 'Priority' to 'High' and set the 'Due Date' to '2026-03-01' for the task page titled 'Database Migration' within my project database."

Tips & Limitations

• Token Security: Always ensure your NOTION_TOKEN is loaded securely as an environment variable and never hardcode it into scripts.
• API Versions: This skill adheres to specific Notion API versions (e.g., 2025-09-03). Ensure your database schema matches the expected property formats described in the skill configuration.
• Permissions: If you get a 404 error during a command, verify that you have explicitly shared the page or database with your integration in the Notion interface. The integration cannot 'see' anything not explicitly shared with it.
• Complexity: Complex block manipulation may require custom curl scripts, as standard CLI commands are optimized for page properties and database queries.