← Back to Skills Marketplace
kitakitsune0x

Notion Sync

by kitakitsune0x · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
592
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-notion-sync
Description
Sync local workspace directories and files to Notion pages using the notion-sync CLI or programmatic API. Use when the user wants to push files to Notion, mi...
Usage Guidance
This skill appears to do what it says: mirror a local directory to Notion. Before using it, (1) create a Notion integration with the minimum scopes needed and use that token; (2) keep the generated .notion-sync.json out of version control (the default ignore list already includes it, but double-check your repo’s .gitignore) because it contains the token in plaintext; (3) run sync with --dry-run or --diff first to preview changes; (4) be aware that updates clear and re-append page blocks, which can overwrite existing content in the target Notion pages—test on a dedicated root page or a small sample directory first; and (5) review the token and page sharing settings in Notion so the integration only has access to the intended pages.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-notion-sync Version: 0.1.0 The skill's core functionality involves reading local files and syncing them to Notion, which requires both file system and network access, consistent with its stated purpose. However, the Notion API token is stored in plain text within the `.notion-sync.json` configuration file. While this is a common practice for CLI tools, it represents a vulnerability as it exposes sensitive credentials if the config file is compromised. There is no evidence of intentional malicious behavior such as exfiltration to unauthorized endpoints, persistence mechanisms, or prompt injection attempts designed to subvert the agent's purpose beyond the stated functionality.
Capability Assessment
Purpose & Capability
Name/description, CLI flags, SKILL.md, and source files all consistently implement a Notion syncing tool. Dependencies (@notionhq/client, glob, ignore, etc.) are appropriate for this functionality. No unrelated credentials, binaries, or platform access are requested.
Instruction Scope
Runtime instructions and code operate on the target directory and Notion via the provided token. They do not read unrelated system files or env vars. Important behavioral note: updating a file will cause the tool to clear existing blocks on the corresponding Notion page and re-append content (destructive-within-Notion behavior). SKILL.md documents usage and init flow; nothing unexpected is being transmitted to external endpoints other than Notion's API.
Install Mechanism
This is an instruction-only skill with source included; SKILL.md recommends installing from npm (registry). There is no remote arbitrary download URL or archive extraction in the skill metadata. package.json and package-lock.json show normal npm dependencies.
Credentials
No environment variables are required by the skill metadata. The tool requires a Notion token provided at init and stores it in plaintext inside .notion-sync.json in the project root. The default ignore set includes '.notion-sync.json' (so the config should be ignored by git by default), but if committed the token could be exposed. The tool needs readonly/write access to the specified directory and write access in Notion — both are expected for the stated purpose.
Persistence & Privilege
always is false and the skill does not request persistent presence or modify other skills or global agent settings. It writes its own .notion-sync.json config in the user's project directory (expected behavior).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-notion-sync
  3. After installation, invoke the skill by name or use /openclaw-notion-sync
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
notion-sync 0.1.0 initial release - Syncs local directories and files into Notion, mirroring folders as pages and files as sub-pages. - CLI commands for initializing config, syncing, ignore pattern management, and checking sync status. - Programmatic API for custom integrations. - Uses checksums for efficient diff-based syncing and supports dry-run previews. - Automatic chunking of file contents and robust Notion page handling. - Easily configurable via `.notion-sync.json` with sensible defaults and ignore patterns.
Metadata
Slug openclaw-notion-sync
Version 0.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Notion Sync?

Sync local workspace directories and files to Notion pages using the notion-sync CLI or programmatic API. Use when the user wants to push files to Notion, mi... It is an AI Agent Skill for Claude Code / OpenClaw, with 592 downloads so far.

How do I install Notion Sync?

Run "/install openclaw-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 (open-source). 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 kitakitsune0x (@kitakitsune0x); the current version is v0.1.0.

💬 Comments