dvcrn Notion Powertools
A comprehensive Notion API toolkit for managing pages, databases, blocks, and content directly from the command line. Create and update pages, query databases with filters, manage block content, search across your workspace, and export structured data — all using the official Notion API with your own integration token.
Description
Notion Powertools provides full programmatic access to your Notion workspace. Whether you need to automate content creation, query databases for reporting, manage page properties, or bulk-update blocks, this skill handles it all through a clean CLI interface. Supports formatted output in table, JSON, or markdown formats.
Requirements
NOTION_API_KEY— Your Notion integration token (starts withntn_orsecret_)- Create an integration at https://www.notion.so/my-integrations
- Share target pages/databases with your integration
Commands
append-block— Error: --page-id requiredcreate-page— Error: --database-id requireddatabase-id— -gt 0 ]; doget-page— Error: --page-id requiredlist-blocks— Error: --page-id requiredlist-databases— Execute list-databasesquery-database— Error: --database-id requiredstdin— Execute stdinupdate-page— Error: --page-id required
Environment Variables
| Variable | Required | Description |
|---|---|---|
NOTION_API_KEY |
Yes | Notion integration token |
NOTION_OUTPUT_FORMAT |
No | Output format: table (default), json, markdown |
Examples
# Search for pages
NOTION_API_KEY=ntn_xxx notion-powertools search "Meeting Notes"
# Query a database with filter
NOTION_API_KEY=ntn_xxx notion-powertools db query abc123 '{"property":"Status","select":{"equals":"In Progress"}}'
# Create a new page
NOTION_API_KEY=ntn_xxx notion-powertools page create parent123 "New Task" '{"Status":{"select":{"name":"Todo"}}}'
# Append content to a page
NOTION_API_KEY=ntn_xxx notion-powertools block append page123 "Hello world" paragraph
# List workspace users
NOTION_API_KEY=ntn_xxx notion-powertools user list
Output Formats
- table — Human-readable formatted table (default)
- json — Raw JSON response from API
- markdown — Markdown-formatted output for docs/notes
💬 Feedback & Feature Requests: https://bytesagain.com/feedback Powered by BytesAgain | bytesagain.com