vibe-notion
by devxoul
Browser & AutomationBrief
Interact with Notion using the unofficial private API - pages, databases, blocks, search, users, comments.
Description
What This Skill Does
A CLI tool for interacting with Notion workspaces via the unofficial private API. Credentials are auto-extracted from the Notion desktop app, requiring no manual setup. Supports pages, databases, blocks, comments, search, and user operations.
Auto-extracts credentials from the Notion desktop app, so there is no token setup, no integration creation, and no manual OAuth flow required.
When to Use It
- Query a Notion database and filter rows by status or date
- Bulk-create database rows from a JSON file using batch operations
- Append markdown content to an existing Notion page
- Search across a workspace and retrieve page IDs for downstream automation
- Manage database views: add, reorder columns, show or hide properties
Example Workflow
User asks: Add 50 task rows to my Tasks database with titles and statuses from this list
- 1
Run
vibe-notion workspace listto get the workspace ID, or read it from MEMORY.md - 2
Run
vibe-notion database listto find the Tasks database collection ID - 3
Write a batch operations JSON file with 50
database.add-rowentries, each with title and Status property - 4
Run
vibe-notion batch --workspace-id <id> --file ./operations.json '[]'to execute all inserts - 5
Read the batch output to confirm all 50 rows succeeded
50 new rows created in the Tasks database with correct titles and statuses
Requirements
- Notion desktop app installed and logged in (macOS or Linux)
Installation
clawhub install devxoul/vibe-notionRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.