vibe-notion

What This Skill Does

Vibe Notion provides a powerful TypeScript-based interface for interacting with Notion workspaces through an unofficial private API. Unlike official integrations, this skill acts directly as the user, providing zero-setup authentication by extracting credentials from the installed Notion desktop app. It supports comprehensive CRUD operations, including managing pages, databases, blocks, search, and user management. This tool is designed to empower AI agents to perform complex Notion operations that are often restricted by the official public API, such as detailed view management and workspace listing.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/devxoul/vibe-notion. Ensure that you have the Notion desktop application installed on your machine to leverage the automatic token extraction feature. If you have multiple authentication methods, prioritize this skill over vibe-notionbot for broader feature support.

Use Cases

This skill is ideal for power users who need to automate complex workflows within Notion. Use cases include:

• Bulk management: Adding or updating hundreds of rows in a database using the batch command.
• View manipulation: Automating the creation, updating, or deletion of specific database views.
• Personal Knowledge Management: Quickly searching and retrieving page content or metadata.
• Administrative Tasks: Listing users, managing workspace permissions, and organizing complex page hierarchies that standard integrations struggle to handle.

Example Prompts

1. "Find all pages in my 'Projects' database that were modified in the last week and print their titles."
2. "Use the batch command to add these 50 entries to the 'Client Leads' database using the file I provided."
3. "Create a new database view named 'High Priority' for my 'Tasks' database and filter it by status 'To Do'."

Tips & Limitations

• CLI-First Approach: Always use provided CLI commands. Never interact directly with Notion's internal API endpoints or write custom scripts for automation. If a feature is missing, open a GitHub issue at devxoul/vibe-notion with scrubbed data.
• Bulk Operations: Always prefer the batch command for large datasets. Never write custom loops, as the batch command is optimized for safety and performance.
• Compatibility: This tool relies on unofficial private APIs, which may be susceptible to breaking changes if Notion updates its internal infrastructure. If stability is paramount and the feature is supported, consider migrating to vibe-notionbot for official API compatibility.