notion

What This Skill Does

The notion skill is a robust integration designed for OpenClaw agents to interface directly with the Notion API using managed OAuth. By utilizing the Maton gateway, this skill allows your agent to perform complex operations within your Notion workspaces, including querying databases, creating or updating pages, managing blocks, and executing workspace-wide searches. This eliminates the need for manual API key management and complex OAuth flow handling within your agent's own logic, as the skill automatically handles token injection and authentication headers.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/byungkyu/notion-api-skill

Ensure you have your Maton API key generated and stored in your system environment variables as MATON_API_KEY. You will also need to manage your Notion OAuth connections via the Maton control dashboard at https://ctrl.maton.ai to ensure your agent has the necessary permissions to access your private Notion data.

Use Cases

• Project Management Automation: Automatically create tasks in Notion from Slack messages or emails processed by your agent.
• Content Pipeline: Sync data from external research tools directly into a Notion database for centralized tracking.
• Documentation Search: Enable your agent to query internal meeting notes, wikis, or project requirements stored in Notion to answer technical questions.
• Reporting: Aggregate data from multiple Notion database entries to generate automated weekly summaries or status reports.

Example Prompts

1. "Search my Notion workspace for the meeting notes from last Friday and summarize the action items for me."
2. "Create a new page in the 'Engineering Tasks' database titled 'Deploy New API Version' with the status set to 'To Do'."
3. "Find the block ID for the Q1 Roadmap section in my 'Product Strategy' page and append a note about the budget update."

Tips & Limitations

• Version Control: Always ensure your requests include the Notion-Version: 2025-09-03 header to maintain compatibility with the gateway.
• OAuth Flow: Remember that you must open the url returned by the connection creation endpoint in a browser to authorize the initial access token.
• Security: Do not hardcode your MATON_API_KEY in scripts. Always use environment variables to keep your credentials secure.
• Permissions: Ensure the internal integration in Notion has the appropriate read/write access to the specific pages or databases you intend to manipulate.