← Back to Skills Marketplace
Vibe Notionbot
by
Jeon Suyeol
· GitHub ↗
· v1.5.0
· MIT-0
761
Downloads
0
Stars
0
Active Installs
14
Versions
Install in OpenClaw
/install vibe-notionbot
Description
Interact with Notion workspaces using official API - manage pages, databases, blocks, users, and comments
Usage Guidance
This skill is plausibly a normal Notion CLI, but there are unresolved red flags you should address before installing or granting access: 1) The runtime docs require NOTION_TOKEN (a Notion integration secret) but the skill metadata does not declare it — expect to provide that token; only grant the minimum scopes needed. 2) The npm package provenance is missing (no source or homepage). Before installing, verify the 'vibe-notion' package on the npm registry, inspect its repository and README, and review the package contents (scripts, postinstall hooks) locally or in a sandbox. 3) Be careful with local files: the CLI can upload local markdown/images — do not pass sensitive files. 4) Prefer installing in a controlled environment (container or VM) if you plan to try it, and audit the binary that is produced. 5) If you cannot find a reputable upstream repo or package author, treat the package as untrusted and do not provide your NOTION_TOKEN. If you want, I can list exact checks to perform on the npm package (package.json, repository URL, maintainers, install scripts) or help craft minimal Notion integration permissions to limit risk.
Capability Analysis
Type: OpenClaw Skill
Name: vibe-notionbot
Version: 1.5.0
The vibe-notionbot skill bundle provides a comprehensive CLI interface for interacting with the Notion API, covering pages, databases, and block management. While the documentation mentions an alternative CLI (vibe-notion) capable of auto-extracting session tokens from the Notion desktop app—a high-risk credential access behavior—it is presented as a documented 'zero setup' feature for the user. The instructions in SKILL.md are well-structured and include security-conscious guidance, such as directing the AI agent to strip PII before filing feature requests and using the CLI wrapper to avoid accidental credential exposure in logs. No evidence of malicious intent, unauthorized data exfiltration, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's name and description match the instructions: it is a CLI wrapper for the official Notion API and exposes many Notion operations. Requiring a CLI binary (vibe-notionbot) and offering page/database/block commands is coherent with the purpose.
Instruction Scope
The SKILL.md instructs runtime use of the vibe-notionbot CLI and describes reading local files (e.g., --markdown-file, auto-uploading local images) and using an Integration token via NOTION_TOKEN. However the skill forbids calling the Notion API directly and forbids writing scripts — these are policy-like constraints that limit alternatives but are not themselves harmful. Crucially, the runtime instructions rely on an environment variable (NOTION_TOKEN) and local files, yet the skill metadata does not declare this env var or any required config paths, creating an incoherence between what the instructions expect and what the metadata promises.
Install Mechanism
The install spec is a Node (npm) package: 'vibe-notion' which installs the 'vibe-notionbot' binary. Installing an npm package is common for a CLI, but the skill metadata has no source/homepage and the registry metadata lists 'Source: unknown' and no homepage — lack of provenance increases risk because the package contents and repository can't be reviewed from the skill metadata alone.
Credentials
The tool requires an integration token (NOTION_TOKEN) to operate according to SKILL.md, but requires.env is empty and no primaryEnv is declared. This omission is a mismatch: the skill will need a secret (NOTION_TOKEN) to function, yet it does not declare it. Requesting a Notion integration token would be proportionate to the stated purpose, but the omission reduces transparency and could hide required privileges.
Persistence & Privilege
The skill does not request always:true, does not require system config paths, and is user-invocable only. No unusual persistence or elevated platform privileges are requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install vibe-notionbot - After installation, invoke the skill by name or use
/vibe-notionbot - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.0
v1.5.0 is a documentation update.
- Updated SKILL.md to reflect current features and usage for vibe-notionbot.
- No changes to the CLI tool itself; commands and usage are unchanged.
- Clarifies best practices, supported commands, and skill limitations.
v1.4.0
v1.4.0
- Updated version number to 1.4.0 in SKILL.md.
- No other changes to functionality or documentation.
v1.3.1
- Bumped version number to 1.3.1 in SKILL.md.
- No feature changes or command updates; documentation only change.
v1.3.0
v1.3.0
- Updated SKILL.md version to 1.3.0.
- No other functional or documentation changes included in this update.
v1.2.2
v1.2.2 is a documentation-only update.
- Updated the SKILL.md file to reflect the new version (1.2.2).
- No changes to functionality or commands; documentation only.
v1.2.1
v1.2.1 is a minor update with documentation changes only.
- Updated SKILL.md version to 1.2.1.
- No changes to commands or functionality—only documentation updated.
v1.2.0
Version 1.2.0
- Updated documentation for the `database update` command to include examples that specify the `--properties` flag.
- Added more comprehensive usage examples for updating database schema and properties.
- Clarified the use of the `--title` and `--properties` flags in the `database update` command.
- No changes to implementation or functionality; documentation only.
v0.9.0
v0.9.0 is a documentation update.
- Updated SKILL.md to reflect version 0.9.0.
- No CLI commands or feature changes; instructions and examples remain the same.
v0.8.1
- Bumped version to 0.8.1 in SKILL.md.
- No other content or feature changes included.
v0.8.0
v0.8.0 adds advanced markdown and block features.
- Added support for uploading local images in markdown files (auto-uploaded/embed when creating/updating pages and blocks)
- New options to append markdown with nested lists as indented child blocks
- Added ability to append or insert blocks before/after specific blocks using --after and --before
- Introduced block file upload: upload images or files as image/file blocks with block upload command
- Updated documentation to include all new CLI options and examples
v0.6.0
Version 0.6.0
- Updated documentation in SKILL.md.
- Version number incremented to 0.6.0.
- No functional or CLI command changes listed; update is documentation-focused.
v0.5.3
- Added a new section explaining the difference between the two CLIs: `vibe-notion` (unofficial API) and `vibe-notionbot` (official API), including a decision flow table to guide users on which to use.
- Clarified usage recommendations based on authentication method and available features.
- No changes to CLI commands or API coverage; documentation update only.
- Incremented version to 0.5.3 to reflect documentation improvements.
v0.5.2
- Updated version to 0.5.2 in SKILL.md.
- No other changes to commands or functionality documented.
v0.5.1
v0.5.1
- Improved documentation and usage guidance in SKILL.md.
- Expanded examples and clarified best practices for CLI usage.
- Added strict instructions to avoid direct API calls and scripting; emphasized use of CLI batch for bulk operations.
- Included detailed command references and usage for pages, databases, blocks, users, comments, and batch actions.
Metadata
Frequently Asked Questions
What is Vibe Notionbot?
Interact with Notion workspaces using official API - manage pages, databases, blocks, users, and comments. It is an AI Agent Skill for Claude Code / OpenClaw, with 761 downloads so far.
How do I install Vibe Notionbot?
Run "/install vibe-notionbot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Vibe Notionbot free?
Yes, Vibe Notionbot is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Vibe Notionbot support?
Vibe Notionbot is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Vibe Notionbot?
It is built and maintained by Jeon Suyeol (@devxoul); the current version is v1.5.0.
More Skills