A developer-centric CLI for reading, editing, and writing Notion pages as Markdown with local reversible changesets and transaction-like rollbacks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install solid-notion
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 solid-notion 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 solid-notion?
solid-notion is a high-performance CLI tool designed to bridge the gap between Notion's structured block storage and the developer's preference for Markdown. It allows users to pull remote Notion pages into local workspaces, edit them as standard Markdown files, and push changes back with full version control. By integrating this skill via Openclaw Skills, developers can automate documentation workflows, manage database entries, and perform precise content updates programmatically.
The tool is built with a focus on data integrity, offering a local-first approach where changes are staged as edits before being submitted. This ensures that every update is traceable and reversible, making it an essential utility for anyone using Notion as a knowledge base or project management tool in a technical environment.
solid-notion Use Cases
- Syncing Notion documentation to local repositories for offline editing and version control.
- Programmatically updating Notion page properties like status, priority, or due dates using Openclaw Skills.
- Batch processing Notion content by applying JSON patches to specific blocks without manual UI interaction.
- Creating and archiving Notion pages as part of an automated CI/CD or reporting pipeline.
- Restoring pages to specific historical states using local changeset snapshots.
How solid-notion Works
- The user authenticates with a Notion Internal Integration Token, which is securely stored in a local config file.
- Remote pages are discovered using search or list commands and pulled into a local workspace directory as Markdown files with associated metadata.
- Edits are performed either by modifying the local Markdown file or by piping structured JSON patches into the edit command.
- Pending changes are recorded in local edit logs, which include before-and-after snapshots to enable safe rollbacks.
- The submit command executes a multi-phase transaction that prepares the update, applies changes to the Notion API, and finalizes the version record. If an error occurs during submission, the tool automatically attempts to roll back the page to its original state.
solid-notion Setup
Install the CLI globally via npm:
npm install -g solid-notion
Initialize your authentication token. For secure usage within Openclaw Skills, use the stdin method:
printf "%s" "YOUR_NOTION_TOKEN" | solid-notion init --token-stdin --json
Verify that the integration is active:
solid-notion auth status --json
solid-notion Data Schema & Taxonomy
All skill data is stored in $SOLID_NOTION_HOME, organized by page UUIDs to ensure clear data separation. The schema includes:
| Component | Purpose |
|---|---|
| Workspace Files | Contains page.md (editable content) and .original.md (diff baseline). |
| Edit Logs | JSONL files tracking pending operations (ops) and reasons before submission. |
| Versions | Immutable JSON records located in <page_id>/versions/ documenting every successful submit. |
| Changesets | Full-page Markdown snapshots with YAML frontmatter for historical restoration. |
| Config | Secure config.json containing auth tokens and profile settings. |
solid-notion Advanced Features
- Transactional Rollbacks: Automatic recovery to a previous state if a batch update partially fails.
- JSON Patching: Support for
replace_block_text,append_blocks, andset_propsoperations via programmatic stdin. - Local History Tracking: View and restore specific changesets using the history and restore commands.
- Multi-Profile Support: Manage multiple Notion workspaces or accounts using the
--profileflag. - Metadata Management: Direct control over page icons, covers, and database properties (select, multi-select, date, etc.).
SKILL.md
Loading
Related Openclaw Skills
YouTube Title Generator
An automated AI agent skill that transforms content ideas into 30 high-performing, psychologically optimized YouTube titles using proven marketing formulas.
Tweet Ideas Generator
Automatically convert long-form content, articles, or notes into 60 high-impact, categorized tweet ideas for maximum social media engagement.
Swipe File Generator
An automated content analysis engine that transforms high-performing URLs into recreatable writing templates and psychological blueprints.
Creative Thought Partner
A conversational AI agent designed to uncover unique insights and crystallize original frameworks through critical observation and paradox hunting.
UE Asset Finder
A specialized utility for scanning and identifying Unreal Engine project assets across complex directory structures.
Unreal Engine Build & Package
A professional automation tool for compiling, cooking, and packaging Unreal Engine projects across multiple platforms.
Featured*
