A managed OAuth gateway skill that enables AI agents to query databases, search pages, and manage content within Notion workspaces.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-maton
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install notion-maton using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Notion AI Integration Skill?
This skill provides a streamlined interface for AI agents to interact with the Notion API through a managed gateway. By handling the complexities of OAuth authentication and token lifecycle management, it allows developers to focus on building agentic workflows rather than infrastructure.
Integrating this tool within Openclaw Skills ensures that your AI coding agents can seamlessly read from and write to Notion databases, update page properties, and manipulate block-level content. The gateway acts as a secure proxy, automatically injecting authorization headers while providing full access to native Notion API endpoints.
Notion AI Integration Skill Use Cases
- Building AI agents that can search and retrieve internal documentation for RAG workflows.
- Automating the creation of meeting notes and database entries from external triggers.
- Synchronizing project management databases with CLI tools or other integrated services.
- Managing block-level content for automated wiki updates and report generation.
How Notion AI Integration Skill Works
- The developer registers for an API key at maton.ai to access the gateway.
- A connection request is initiated to link a specific Notion workspace.
- The user completes a one-time OAuth handshake in the browser to authorize access.
- The AI agent sends standard REST requests to the gateway URL, specifying the target Notion endpoint.
- The gateway identifies the connection, injects the managed OAuth token, and proxies the request to the official Notion API.
Notion AI Integration Skill Setup
First, obtain your API key from the settings dashboard. Then, export it to your environment:
export MATON_API_KEY="YOUR_API_KEY"
Create a new connection to initialize the OAuth flow:
curl -X POST https://ctrl.maton.ai/connections \
-H "Authorization: Bearer $MATON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"app": "notion"}'
Open the URL returned in the response to authorize the application in your Notion workspace.
Notion AI Integration Skill Data Schema & Taxonomy
The skill organizes interaction based on Notion's core data models, utilizing UUIDs for all identifiers. It distinguishes between Databases and Data Sources for more efficient querying.
| Concept | Use For |
|---|---|
| Database | Creating new databases and retrieving data source IDs. |
| Data Source | Querying entries, updating schemas, and managing properties. |
| Page | Storing properties and serving as a parent for content blocks. |
| Block | Representing granular content types like paragraphs, headings, or images. |
Notion AI Integration Skill Advanced Features
- Multi-connection support via the Maton-Connection header for managing multiple Notion workspaces.
- Support for the latest Notion API versions (e.g., 2025-09-03).
- Advanced search filters to isolate specific object types like pages or data sources.
- Managed block-children manipulation for complex content appending and deletion.
SKILL.md
Loading
Related Openclaw Skills
TickerDB Market Intelligence
TickerDB provides AI agents with pre-computed, categorical market context to improve financial reasoning and significantly reduce token consumption.
58 Block City
A blockchain-powered digital city service platform offering urban popularity tracking, NFT management, and digital block analytics.
Auto PRD Hunter
An AI-powered research agent that scans web platforms for real user pain points to generate comprehensive Product Requirements Documents in JSON format.
Hoist
Hoist is an AI-native CLI designed to help agents deploy and manage apps, servers, and databases on VPS providers with automated JSON output.
Query-Skills
A powerful search and discovery engine for finding and exploring Openclaw Skills across multiple sources in both English and Chinese.
Knowledge Structured Archiving
A sophisticated knowledge management tool that decomposes unstructured documents into standardized, indexed, and searchable theme directories.
Featured*
