A comprehensive Python-based toolset for managing Notion pages, databases, and content blocks through the official REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-skill-notion-workspace
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 openclaw-skill-notion-workspace 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 Workspace Skill?
The Notion Workspace skill is a developer-centric integration designed to bridge the gap between your local environment and your Notion knowledge base. As a key component of the Openclaw Skills library, it allows for seamless interaction with the Notion REST API using either a command-line interface or a direct Python module import. This tool simplifies complex API interactions into straightforward commands for searching documentation, reading block-level content, and programmatically updating databases.
By leveraging this skill, users can automate the organization of their digital workspace without the overhead of heavy SDKs. It is built for speed and reliability, utilizing Python standard libraries to ensure a lightweight footprint while providing robust access to Notion's structured data. Whether you are building an AI agent to summarize notes or a CLI tool to log tasks, this skill provides the necessary foundation within the Openclaw Skills ecosystem.
Notion Workspace Skill Use Cases
- Automating the creation of meeting minutes in specific Notion databases.
- Programmatically searching across a workspace to find project documentation.
- Appending automated build logs or status updates to a dedicated Notion page.
- Fetching page content and block metadata for AI-driven analysis.
- Managing complex database properties like Status and Select fields from the terminal.
How Notion Workspace Skill Works
- The skill authenticates with the Notion API using a secure integration token provided via environment variables.
- Users or agents trigger specific actions such as search, read, or create through the Python script or CLI.
- The skill formats these requests into RESTful API calls, handling the necessary JSON payloads and headers.
- Notion processes the request and returns structured data regarding pages, blocks, or database schemas.
- The skill parses the response, providing clean JSON output for the user or further processing within Openclaw Skills workflows.
Notion Workspace Skill Setup
To get started with this skill, follow these steps:
- Create an internal integration in your Notion workspace and obtain the integration token.
- In Notion, open the page or database you want to manage, click Share, and invite your integration.
- Set your environment variable:
export NOTION_TOKEN=ntn_your_token_here
- Verify the setup by listing your databases:
python3 scripts/notion.py databases
Notion Workspace Skill Data Schema & Taxonomy
The skill organizes its operations around the standard Notion object model. Below is how the data and files are structured:
| File | Purpose |
|---|---|
scripts/notion.py |
The core execution engine for CLI commands and Python imports. |
references/notion-api.md |
A localized reference guide for API endpoints and block types. |
Data Entities:
- Pages: Handled as JSON objects containing properties (titles, dates, selects) and unique IDs.
- Blocks: Represent the actual content within a page (e.g., paragraphs, headings), accessible via the
--blocksflag. - Databases: Organized by ID, allowing for structured page creation with predefined schemas.
Notion Workspace Skill Advanced Features
- Direct Python module support for building custom automation logic on top of Openclaw Skills.
- Support for complex property mapping using raw JSON strings for database entries.
- Metadata-only or full-block content retrieval options for optimized data usage.
- Automatic sanitization and formatting of Notion IDs (supports both dashed and non-dashed formats).
- Lightweight implementation using urllib, ensuring compatibility across environments with minimal dependencies.
SKILL.md
Loading
Related Openclaw Skills
ElevenLabs Pro
A high-performance text-to-speech skill for ElevenLabs providing advanced voice selection and audio generation.
contact-finder
A lead discovery tool that leverages search engines and AI to find and validate professional contact information.
Brave Rotator
A utility that manages multiple Brave Search API keys via round-robin rotation to maximize free-tier limits and handle rate-limiting automatically.
Nexus-Safe
An autonomous local system reliability agent designed to monitor health and securely recover services within the OpenClaw ecosystem.
R2 Storage Management
A comprehensive interface for managing Cloudflare R2 object storage through boto3 and S3-compatible APIs within an AI agent environment.
Supervisor
An autonomous agent skill that monitors server health and automatically repairs failed services and containers.
Featured*
