vibe-notion

Enables AI agents to read and write Notion workspaces via the private API.

44|6|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/devxoul/vibe-notion --skill vibe-notion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vibe-notion
Source: https://github.com/devxoul/vibe-notion/tree/main/skills/vibe-notion
Command: npx skills add https://github.com/devxoul/vibe-notion --skill vibe-notion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AI agents often struggle to interact with Notion due to API limitations and credential handling; this skill provides a bridge to read and write Notion content via the unofficial private API.

Core Features & Use Cases

  • Read and modify pages, databases, blocks, and search using the vibe-notion private API (unofficial) and the vibe-notionbot official API for bot interactions.
  • Credentials are auto-extracted from the Notion desktop app or supplied via NOTION_TOKEN, with memory across sessions.
  • Supports agent memory, batch operations, and safe, deterministic CLI workflows for AI-driven Notion work.

Quick Start

Use vibe-notion to connect to your workspace and start managing pages, databases, and blocks with AI-driven commands.

Frequently Asked Questions about vibe-notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How can an AI agent read and write Notion pages privately without official API limits?

AI agents can manage Notion pages and databases privately by using the unofficial Notion private API, which enables direct reading and writing of workspace content without standard API limitations. Credentials are auto-extracted from the desktop app or set via NOTION_TOKEN.

How do I set up credentials for AI-driven Notion workspace automation?

To set up Notion automation credentials, provide a NOTION_TOKEN environment variable or let the system auto-extract credentials from the local Notion desktop app. This enables authenticated access for managing pages, databases, and blocks across multiple workspaces.

Can I search across multiple Notion workspaces using a CLI?

Yes, you can search across multiple Notion workspaces using CLI tools designed for AI agents. The system manages local memory for workspace IDs and resource references, allowing deterministic CLI workflows to query and modify content across connected workspaces.

Does managing Notion blocks and databases with AI require the official API?

No, managing Notion blocks and databases with AI does not require the official API. This approach uses the unofficial private API for direct workspace operations, requiring only the Notion private API access and specific CLI tools for execution.

What are the limitations of using the unofficial Notion private API for automation?

Using the unofficial Notion private API for automation requires local memory management for workspace IDs and depends on specific CLI tools. As an unofficial interface, it may lack official API stability guarantees and requires private API access to function correctly.

What is the best way to batch update Notion databases with an AI agent?

The best way to batch update Notion databases with an AI agent is using deterministic CLI workflows that support batch operations. This method leverages the unofficial private API to safely read and modify database blocks while maintaining session memory.