A high-performance CLI for managing Notion workspaces, databases, and pages without needing manual UUIDs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notioncli
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 notioncli 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 notioncli?
notioncli is a powerful interface for the Notion API designed for both human developers and AI agents. It simplifies complex Notion interactions by using auto-generated aliases for databases, allowing users to query, update, and manage content using human-readable names instead of long UUIDs. This skill is a core part of the Openclaw Skills ecosystem, enabling seamless automation of documentation, database management, and task tracking directly from the terminal or an AI agent workflow.
By streamlining the authentication and database discovery process, notioncli reduces the friction of interacting with the Notion ecosystem. It supports everything from simple page creation to complex block-level manipulations and multi-workspace management, making it an essential tool for developers looking to integrate Notion into their automated pipelines.
notioncli Use Cases
- Automating task creation and status updates in Notion databases.
- Fetching page content and blocks for AI-driven analysis or summarization.
- Managing multiple Notion workspaces and accounts from a single terminal interface.
- Uploading files and adding comments to collaborate asynchronously within Notion pages.
- Synchronizing local data with Notion databases using CSV, YAML, or JSON exports.
How notioncli Works
- Initialize the CLI with your Notion API key to authenticate and automatically discover all shared databases.
- Assign human-readable aliases to databases to avoid typing long UUIDs during command execution.
- Execute targeted commands to query data, create pages, or modify blocks using flexible filters and property flags.
- Leverage multi-workspace profiles to switch between different Notion environments effortlessly with per-command overrides.
- Process output in various formats like table, CSV, or JSON for programmatic use within the Openclaw Skills framework.
notioncli Setup
Install the package globally and initialize your workspace with your API key:
npm install -g @jordancoin/notioncli
notion init --key $NOTION_API_KEY
Note: You must share each database with your integration in Notion by navigating to the database menu, selecting Connections, and adding your specific integration.
notioncli Data Schema & Taxonomy
The skill organizes data around the Notion API structure, optimized for CLI readability and automation:
| Component | Description | Metadata Used |
|---|---|---|
| Databases | Accessed via human-readable aliases (slugs). | UUID, Title, Schema |
| Pages | Individual entries within databases or standalone. | Page ID, Properties, Parent ID |
| Blocks | Granular content elements like text, headings, and lists. | Block ID, Type, Content |
| Workspaces | Scoped profiles for different Notion accounts. | Profile Name, API Key |
| Aliases | Local mapping of short names to database UUIDs. | Slug, Database ID |
notioncli Advanced Features
- Support for Relations and Rollups with automatic title resolution for linked pages.
- Block-level CRUD operations including appending, editing, and deleting specific content pieces.
- Automatic handling of dual IDs for the latest Notion API data source specifications.
- Multi-workspace profile management allowing seamless switching between work and personal accounts.
- File upload support for images, PDFs, and documents with automatic MIME type detection.
- Flexible output formatting including ASCII tables, CSV, YAML, and raw JSON for developer workflows.
SKILL.md
Loading
Related Openclaw Skills
atl-browser
A high-performance automation layer for AI agents to control iOS simulators through both mobile Safari and native applications.
trainedby-mcp Personal AI Coach
A personal AI coaching skill that connects health data, fitness goals, and training reflections to your AI agent via the trainedby.ai MCP server.
OpenClaw Starter Guide
A strategic roadmap for deploying, configuring, and optimizing cost-effective multi-agent AI systems from zero to professional scale.
Callmac: Remote Voice Control for Mac
Control your Mac's voice remotely from mobile devices to play announcements, alarms, and stories using high-quality neural TTS.
Google Search
A powerful search integration allowing AI agents to perform real-time Google searches to retrieve live information from across the web.
Instagram Skill
A specialized integration enabling AI agents to automate content publishing, engagement, and data retrieval on the Instagram platform.
Featured*
