A secure interface for AI agents to interact with Notion workspaces using the Model Context Protocol and UXC CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-mcp-skill
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-mcp-skill 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 MCP Skill?
The Notion MCP skill is a professional-grade integration that allows AI agents and developers to manage Notion workspace content through the Model Context Protocol (MCP). By utilizing the UXC CLI, this skill provides a standardized way to search for pages, fetch database schemas, and perform updates with built-in safety controls. It is a core component for those building automated workflows within the Openclaw Skills ecosystem.
This skill prioritizes security and data integrity by implementing OAuth 2.0 with PKCE and enforcing a read-before-write logic. Whether you are automating project management or building a personal knowledge base assistant, this skill provides the necessary tools to interact with Notion's complex API in a structured, agent-friendly format.
Notion MCP Skill Use Cases
- Searching a workspace to find specific project documentation or meeting notes.
- Programmatically creating and updating database entries for task management.
- Fetching page content to serve as context for AI-driven summarization and analysis.
- Managing workspace users and teams via command-line operations.
- Syncing external data sources into Notion databases with schema verification.
How Notion MCP Skill Works
- The operator initiates an OAuth 2.0 handshake through the UXC CLI to grant the agent access to the Notion workspace.
- The Openclaw Skills agent maps the Notion MCP endpoint to a local command for consistent execution.
- The agent performs a discovery step to inspect available tools and the specific properties of targeted Notion databases.
- Read operations like search or fetch are executed first to ensure the agent has the latest state of the content.
- Write operations are processed with structured JSON payloads, requiring explicit user confirmation for high-impact changes like page updates or deletions.
- All responses are parsed through a stable JSON envelope to ensure reliable error handling and data extraction.
Notion MCP Skill Setup
To get started with this skill, ensure the UXC CLI is installed and then follow these steps:
# 1. Start the OAuth login process
uxc auth oauth start notion-mcp --endpoint mcp.notion.com/mcp --redirect-uri http://127.0.0.1:8788/callback --scope read --scope write
# 2. Complete the login using the callback URL provided by the browser
uxc auth oauth complete notion-mcp --session-id <session_id> --authorization-response '<callback-url>'
# 3. Bind the endpoint to the created credential
uxc auth binding add --id notion-mcp --host mcp.notion.com --path-prefix /mcp --scheme https --credential notion-mcp --priority 100
# 4. Link the command for easy access
uxc link notion-mcp-cli mcp.notion.com/mcp
Notion MCP Skill Data Schema & Taxonomy
The skill interacts with Notion data using a structured format that ensures compatibility across various Openclaw Skills.
| Command | Primary Data Input | Output Format |
|---|---|---|
notion-search |
Query String | Array of page/database objects |
notion-fetch |
Page ID or URL | Detailed page content and metadata |
notion-update-page |
Page ID + Properties | JSON confirmation of changes |
notion-create-page |
Parent ID + Properties | JSON object of the new page |
All output is wrapped in a standard JSON envelope containing ok, kind, protocol, and data fields.
Notion MCP Skill Advanced Features
- Support for OAuth 2.0 with PKCE for secure, token-based authorization.
- Schema inspection capabilities to dynamically adapt to custom Notion database properties.
- Guarded write behavior that mandates user approval for destructive or high-impact actions.
- Multi-agent compatibility through the standardized UXC link and binding system.
- Detailed error recovery playbooks integrated with the broader Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
Linear GraphQL Skill
A robust interface for AI agents to interact with Linear's GraphQL API for issue management and team collaboration.
Etherscan MCP Skill
A high-performance interface for onchain investigation, providing deep access to Ethereum blockchain data via the Etherscan MCP.
Dune MCP Skill
A powerful tool for AI agents to discover, query, and visualize blockchain data directly from Dune Analytics.
DeepWiki MCP Skill
A powerful tool to interact with GitHub repository documentation and get AI-grounded answers about codebases.
OKX OnchainOS MCP Skill
A comprehensive DeFi automation skill for accessing OKX OnchainOS market data, wallet balances, and DEX swap execution via uxc.
Playwright MCP Skill
Automate web browsers through the Model Context Protocol using Playwright and uxc for reliable agentic web interaction.
METADATA
Featured*
