Vibe Notion

Give your AI agent the power to read and write Notion pages, databases, and more.

A full-coverage, agent-friendly CLI for the Notion API. Ships two CLIs — vibe-notion for the unofficial private API (act as yourself) and vibe-notionbot for the official Integration API (act as a bot).

Table of Contents

• Why Vibe Notion?
• Installation
• Agent Skills
• Quick Start
• Command Overview
• Use Cases
• Philosophy
• Contributing
• License

Why Vibe Notion?

Notion's official API only supports Integration (bot) tokens — your agent can't do things on behalf of you. Vibe Notion solves this by extracting your token_v2 from the Notion desktop app, so your agent operates as you, with your full permissions.

Need official API access instead? vibe-notionbot is included and fully supports Integration tokens via NOTION_TOKEN.

• Act as you — vibe-notion extracts token_v2 from the Notion desktop app to operate with your own permissions
• Bot support too — vibe-notionbot supports official Integration tokens via NOTION_TOKEN
• Full API coverage — Pages, databases, blocks, users, search, comments, and workspaces