LaunchKit · 2026
Back to Skills

vibe-notion

Interact with Notion using the unofficial private API - pages, databases, blocks, search, users, comments.

0
454 downloads
by @devxoul

Setup & Installation

openclaw skills install @devxoul/vibe-notion

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install vibe-notion

Version History

v1.2.2Mar 16, 2026 - Version note by skill developer:

v1.2.2 - Updated SKILL.md documentation only. - Clarified usage, memory management, and command guidelines for the `vibe-notion` CLI. - No changes to code or CLI functionality.

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Add 50 task rows to my Tasks database with titles and statuses from this list

AGENT
  1. 1Run `vibe-notion workspace list` to get the workspace ID, or read it from MEMORY.md
  2. 2Run `vibe-notion database list` to find the Tasks database collection ID
  3. 3Write a batch operations JSON file with 50 `database.add-row` entries, each with title and Status property
  4. 4Run `vibe-notion batch --workspace-id <id> --file ./operations.json '[]'` to execute all inserts
  5. 5Read the batch output to confirm all 50 rows succeeded
OUTPUT

50 new rows created in the Tasks database with correct titles and statuses

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Notion desktop app installed and logged in (macOS or Linux)