vibe-notionbot
by devxoul
Web & Frontend DevelopmentBrief
Interact with Notion workspaces using official API - manage pages, databases, blocks, users, and comments.
Description
What This Skill Does
CLI tool for interacting with Notion workspaces via the official API. Manages pages, databases, blocks, users, comments, and search using an integration token. Supports batch operations for bulk writes without scripting.
Uses the official versioned Notion API, so it stays stable across Notion updates unlike tools that rely on the private internal API.
When to Use It
- Creating database entries from CI pipeline output
- Appending meeting notes to an existing Notion page
- Querying a project tracker database for in-progress items
- Bulk-creating pages from a structured data file
- Adding comments to pages programmatically from an agent workflow
Example Workflow
User asks: Add a new row to my Tasks database with title 'Fix login bug' and Status 'In Progress'
- 1
Run
vibe-notionbot database listto find the Tasks database ID - 2
Run
vibe-notionbot page create --parent <database_id> --title 'Fix login bug' --databaseto create the row - 3
Run
vibe-notionbot page update <page_id> --set 'Status=In Progress'to set the property
A new page/row exists in the Tasks database with the correct title and status
Requirements
- NOTION_TOKEN environment variable (integration token from notion.so/my-integrations)
- Notion integration created at notion.so/my-integrations with access granted to relevant pages
Installation
clawhub install devxoul/vibe-notionbotRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.