A robust command-line interface for creating, reading, and updating Notion pages and databases programmatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-cli
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-cli 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 CLI?
The Notion CLI is a specialized tool designed for developers and power users who need to interact with their Notion workspace directly from the terminal. As a key component of the Openclaw Skills library, it provides a streamlined way to manage complex databases, manipulate page blocks, and automate repetitive documentation tasks without the need for a web browser.
By leveraging the official Notion API, this skill allows for seamless integration into existing developer workflows. Users can perform advanced searches, query databases with complex filters, and update page properties using simple terminal commands, making it an essential utility for anyone looking to build custom automations around their Notion-based knowledge management system.
Notion CLI Use Cases
- Automating the creation of project pages and meeting notes from templates.
- Batch updating task statuses or priorities within a project database.
- Searching for specific content across a large workspace using terminal commands.
- Extracting database records into CSV or JSON formats for data analysis.
- Programmatically appending blocks or content to existing Notion pages.
How Notion CLI Works
- The skill authenticates with the Notion API using a secure internal integration token stored in the environment.
- Users issue commands via the terminal to target specific page or database IDs.
- The CLI processes these requests and communicates with Notion's backend to retrieve or modify data.
- Results are rendered in the terminal using user-defined formats like tables, CSV, or raw JSON for further piping.
Notion CLI Setup
Follow these steps to configure the skill for Openclaw Skills usage:
# Install the CLI tool globally
npm install -g @iansinnott/notion-cli
# Create a config directory and store your API key
mkdir -p ~/.config/notion
echo "your_ntn_token_here" > ~/.config/notion/api_key
# Set the environment variable
export NOTION_TOKEN=$(cat ~/.config/notion/api_key)
Note: You must create an integration at notion.so/my-integrations and share specific pages or databases with that integration to grant access.
Notion CLI Data Schema & Taxonomy
The skill interacts with various Notion property types. Below is the mapping for common data structures:
| Property Type | JSON Structure |
|---|---|
| Title | {"title": [{"text": {"content": "..."}}]} |
| Rich Text | {"rich_text": [{"text": {"content": "..."}}]} |
| Status | {"status": {"name": "Option Name"}} |
| Date | {"date": {"start": "YYYY-MM-DD"}} |
| Multi-select | {"multi_select": [{"name": "A"}, {"name": "B"}]} |
| Checkbox | {"checkbox": true} |
Notion CLI Advanced Features
- Interactive mode for performing complex database queries without remembering syntax.
- Multi-format support including Table, CSV, JSON, and YAML outputs.
- Advanced filter syntax using the -a flag for complex AND/OR conditional logic.
- Raw JSON mode for accessing the complete API response for debugging or custom scripting.
- Automatic rate limit management to ensure stability during high-volume operations.
SKILL.md
Loading
Related Openclaw Skills
Mantis Manager
A comprehensive automation tool for managing Mantis Bug Tracker issues, projects, and users with dynamic multi-instance support.
Tasktrove Todo Management
A comprehensive task management skill for interacting with self-hosted Tasktrove instances to streamline developer workflows.
Feishu Voice Clone TTS Skill
An automation skill that converts text into natural speech using Volcengine TTS and delivers the audio message directly to Feishu chats.
Metricool
A comprehensive automation tool for scheduling and managing social media content across multiple platforms via the Metricool API.
Odoo Manager
A comprehensive tool for managing Odoo instances and business objects via the official XML-RPC API using Openclaw Skills.
Blankspace Agent Registration
A comprehensive developer toolkit for registering AI agents on the Farcaster decentralized social network using the Blankspace launchpad.
Featured*
