← Back to Skills Marketplace
Notion Sync
by
robansuini
· GitHub ↗
· v2.5.3
· MIT-0
4752
Downloads
6
Stars
0
Active Installs
16
Versions
Install in OpenClaw
/install notion-sync
Description
Bi-directional sync and management for Notion pages and databases. Use when working with Notion workspaces for collaborative editing, research tracking, proj...
Usage Guidance
Review before installing if your Notion workspace contains important business or shared data. Use a least-privilege Notion integration shared only with needed pages/databases, protect any token file, run batch updates with --dry-run first, always provide a narrow --filter, and avoid forwarding JSON monitoring output to chat, CI, or alerting systems unless those destinations are approved.
Capability Analysis
Type: OpenClaw Skill
Name: notion-sync
Version: 2.5.3
The notion-sync skill bundle is a well-structured set of tools for interacting with the Notion API using only built-in Node.js modules. It implements several security best practices, including a 'Path Safety Mode' in `notion-utils.js` to prevent path traversal and secure credential handling that avoids exposing tokens in process listings. The code logic is transparent, lacks external dependencies, and strictly aligns with the stated purpose of managing Notion workspaces.
Capability Assessment
Purpose & Capability
Read, create, update, archive, search, and sync operations are coherent for a Notion management skill, but the bundled batch update command can mutate up to 100 database pages by default.
Instruction Scope
The documentation presents a query-mode filter as required, but batch-update.js does not enforce a filter or dry-run before applying changes to all returned pages up to the limit.
Install Mechanism
No install script, package installation, obfuscated setup, or hidden execution mechanism was found; the bundle is markdown plus Node.js scripts using built-in modules.
Credentials
Node.js, Notion API access, and local markdown file reads/writes fit the stated purpose. Local file paths are restricted to the current workspace by default, with an explicit unsafe-path override.
Persistence & Privilege
The skill uses a Notion token from documented sources, including an auto-detected ~/.notion-token file, and watch mode stores page IDs, titles, and timestamps in a documented state file. No background daemon was found.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install notion-sync - After installation, invoke the skill by name or use
/notion-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.5.3
Workspace path safety guard + docs hardening; keeps scanner-aligned metadata and credential-safe token handling.
v2.5.2
Security hardening: workspace-scoped file path safety guards, explicit --allow-unsafe-paths override, docs metadata updates, and test file removed from distributed bundle.
v2.5.1
fix: enforce Notion 2000-char rich_text limit for markdown spans in parseMarkdownRichText to prevent validation errors on long content.
v2.5.0
feat: batch-update.js for bulk property updates (query+update and stdin modes, --dry-run, rate limiting). feat: --json output mode on all scripts for composable piping.
v2.4.0
feat: friendlier error messages, ~ expansion in --token-file, auto-detect ~/.notion-token, --state-file flag for watch-notion
v2.3.0
Add clawdis registry metadata: declares NOTION_API_KEY and node requirements. Scanner should now see matching metadata.
v2.2.0
Security: remove bare --token arg. Credentials only via --token-file, --token-stdin, or NOTION_API_KEY env var. Never exposed in process listings or shell history.
v2.1.0
Add --token-file, --token-stdin, and NOTION_API_KEY env var as secure token input methods. --token still works. 109 tests. Addresses VirusTotal credential exposure concern.
v2.0.0
BREAKING: --token required for all scripts (env var removed). Fully platform-agnostic, zero environment dependencies. 105 tests. See upgrade guide in SKILL.md.
v1.0.6
Remove non-standard env field from frontmatter to resolve scanner metadata inconsistency
v1.0.5
Added homepage, repository, and license to frontmatter for provenance verification. Addresses ClawHub scanner recommendation.
v1.0.4
Security scan fixes: declared NOTION_API_KEY env dependency, made fully platform-agnostic (removed all macOS/OpenClaw references), eliminated code duplication across 6 scripts, centralized shared utils, 100 unit tests, backwards-compatible exports
v1.0.3
- Added test script: `scripts/test-normalize.js` for normalization testing.
- Improved functionality in `scripts/notion-to-md.js`.
- Enhanced monitoring or change detection logic in `scripts/watch-notion.js`.
v1.0.2
- Replaced the old `add-research-to-db.js` script with a new, more general `add-to-database.js` script for adding markdown files as pages to any Notion database.
- Updated documentation to reflect the more flexible workflow for adding content to databases.
- Simplified example commands and removed hardcoded database IDs, making usage examples more portable.
- Cleaned up references to removed scripts and clarified output and feature descriptions in core operation docs.
v1.0.1
Fix: Remove hardcoded environment-specific paths. Script now requires explicit arguments or environment variables for portability.
v1.0.0
Initial release: Bi-directional markdown to Notion sync with database management and change detection
Metadata
Frequently Asked Questions
What is Notion Sync?
Bi-directional sync and management for Notion pages and databases. Use when working with Notion workspaces for collaborative editing, research tracking, proj... It is an AI Agent Skill for Claude Code / OpenClaw, with 4752 downloads so far.
How do I install Notion Sync?
Run "/install notion-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Notion Sync free?
Yes, Notion Sync is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Notion Sync support?
Notion Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Notion Sync?
It is built and maintained by robansuini (@robansuini); the current version is v2.5.3.
More Skills