vibe-notion
Interact with Notion using the unofficial private API - pages, databases, blocks, search, users, comments
Best for Notion power usersWorks with GitHub
⌘source
- author
@LeoYeAI- language
- Python
★2kstars
306forks
May 6, 2026
✦overview.md
Key Features
- ·Full CRUD on pages, databases, blocks
- ·Search and user management
- ·Zero-setup auth via tokenv2 extraction
- ·Unofficial private API support
- ·View management (get, update, list, add, delete)
Use Cases
- →Automating Notion page creation from scripts
- →Bulk database row updates
- →Managing workspace views programmatically
- →Extracting data from Notion via private API
Best for
- ✓Notion power users
- ✓Automation scripts
- ✓Workspace administrators
Not ideal for
- !Official API workflows
- !Production-critical integrations
- !Simple read-only access
FAQs
name
vibe-notion
description
Interact with Notion using the unofficial private API - pages, databases, blocks, search, users, comments
version:1.4.0
allowed-tools:Bash(vibe-notion:*)
metadata:{"openclaw":{"requires":{"bins":["vibe-notion"]},"install":[{"kind":"node","package":"vibe-notion","bins":["vibe-notion"]}]}}
Vibe Notion
A TypeScript CLI tool that enables AI agents and humans to interact with Notion workspaces through the unofficial private API. Supports full CRUD operations on pages, databases, blocks, search, and user management.
Note: This skill uses Notion's internal/private API (
/api/v3/), which is separate from the official public API. For official API access, usevibe-notionbot.
Which CLI to Use
This package ships two CLIs. Pick the right one based on your situation:
vibe-notion (this CLI) | vibe-notionbot | |
|---|---|---|
| API | Unofficial private API | Official Notion API |
| Auth | token_v2 auto-extracted from Notion desktop app | NOTION_TOKEN env var (Integration token) |
| Identity | Acts as the user | Acts as a bot |
| Setup | Zero — credentials extracted automatically | Manual — create Integration at notion.so/my-integrations |
| Database rows | add-row, update-row | Create via page create --database |
| View management | view-get, view-update, view-list, view-add, view-delete | Not supported |
| Workspace listing | Supported | Not supported |
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill vibe-notionSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.