vibe-notion

For Notion, automation is easy. Acting as you isn't. vibe-notion reads the session your Notion desktop app already holds, so your agent edits, comments, and searches as your logged-in account — not as an integration bot. If you do want a bot identity (server, CI/CD), vibe-notionbot ships alongside it and speaks the official Integration API.

Table of Contents

• Why Vibe Notion?
• Installation
• Agent Skills
  • SkillPad
  • Skills CLI
  • Claude Code Plugin
  • OpenCode Plugin
• Quick Start
• Command Overview
• Use Cases
  • Research & Discovery
  • Project Tracking
  • Creating & Writing
  • Automation & Pipelines
  • ...and More
• Philosophy
• Contributing
• License

Why Vibe Notion?

You shouldn't need a bot to edit your own notes.

The Notion MCP and the official Integration API are fine for automation. They share one thing by design: the agent acts as an integration bot, not as you.

Concretely, that means:

• Bot identity on writes. Pages, blocks, and comments created through the official API are attributed to the integration, with its own name and avatar. The last_edited_by and created_by fields return a bot user, not you. (Notion docs)
• Access is integration-scoped. The integration only sees pages that have been explicitly shared with it via "Add connections." Your private drafts and pages you haven't connected stay invisible. (Notion docs)
• Setup needs a workspace owner. Creating an internal integration requires workspace owner privileges — regular members can't.
• No user impersonation. The API has no "act on behalf of" mode. Integration-scoped is the only mode.

That's the right fit for a shared automation or a CI bot. It's the wrong fit when the agent is yours and the work is yours — when a comment should show your face, a page edit should show your name, and your agent should be able to read the private doc you never "connected" anything to.

vibe-notion reads the token_v2 your Notion desktop app is already using, so your agent inherits your session directly.

• Act as you — vibe-notion extracts token_v2 from the Notion desktop app. Edits, comments, and pages are attributed to your account
• See what you see — Anything your logged-in session can open is accessible. No per-page "Add connections" step
• Bot mode included — vibe-notionbot uses official Integration tokens (NOTION_TOKEN) when a bot identity is what you actually want
• Full API coverage — Pages, databases, blocks, users, search, comments, workspaces
• Agent memory — Remembers workspace IDs, page names, and preferences across sessions
• CLI, not MCP — One command per action, loaded through a skill. Smaller tool surface per prompt. (More)

Installation

npm install -g vibe-notion

Or use your favorite package manager. This installs both vibe-notion and vibe-notionbot.

Agent Skills

Vibe Notion ships with Agent Skills that teach your AI agent how to use each CLI. Install only what you need:

• vibe-notion — Act as you (private API, token_v2)
• vibe-notionbot — Act as a bot (official Integration API, NOTION_TOKEN)

SkillPad

SkillPad is a GUI app for Agent Skills. See skillpad.dev for more details.

Skills CLI

Skills CLI is a CLI tool for Agent Skills. See skills.sh for more details.

npx skills add devxoul/vibe-notion

Claude Code Plugin

/plugin marketplace add devxoul/vibe-notion
/plugin install vibe-notion

OpenCode Plugin

Add to your opencode.jsonc:

{
  "plugins": [
    "vibe-notion"
  ]
}

Quick Start