notion-api-automationManage Notion notes, pages, and data sources with a JSON-first CLI for search, read/export, write/import, append, and move operations. Use when working with Notion, organising notes, moving pages, triaging an inbox, or reading/writing page content.
Install via ClawdBot CLI:
clawdbot install tristanmanchester/notion-api-automationPrefer deterministic scripts over ad‑hoc API calls:
This skill ships a single entrypoint CLI: {baseDir}/scripts/notionctl.mjs.
Notion-Version: 2025-09-03 for every request. Retry-After. data_source_id, not database_id.This skill expects NOTION_API_KEY to be present in the environment.
If you need a fallback for local dev, the CLI also checks:
NOTION_TOKEN, NOTION_API_TOKEN~/.config/notion/api_keynode {baseDir}/scripts/notionctl.mjs whoamiSearch pages (title match):
node {baseDir}/scripts/notionctl.mjs search --query "meeting notes" --type pageSearch data sources (title match is against the database container title in 2025-09-03):
node {baseDir}/scripts/notionctl.mjs search --query "Inbox" --type data_sourcenode {baseDir}/scripts/notionctl.mjs export-md --page "<page-id-or-url>"Under a parent page:
node {baseDir}/scripts/notionctl.mjs create-md --parent-page "<page-id-or-url>" --title "Idea" --md "# Idea\n\nWrite it up..."Under a data source (database row):
node {baseDir}/scripts/notionctl.mjs create-md --parent-data-source "<data-source-id-or-url>" --title "Idea" --md "# Idea\n\nWrite it up..."Optional: set properties when parent is a data source:
node {baseDir}/scripts/notionctl.mjs create-md \
--parent-data-source "<data-source-id>" \
--title "Inbox: call plumber" \
--md "- [ ] Call plumber\n- [ ] Ask for quote" \
--set "Status=Inbox" --set "Tags=home,admin" --set "Due=2026-02-03"node {baseDir}/scripts/notionctl.mjs append-md --page "<page-id-or-url>" --md "## Update\n\nAdded more detail."Move under another page:
node {baseDir}/scripts/notionctl.mjs move --page "<page-id-or-url>" --to-page "<parent-page-id-or-url>"Move into a database (data source):
node {baseDir}/scripts/notionctl.mjs move --page "<page-id-or-url>" --to-data-source "<data-source-id-or-url>"create-md with --parent-data-source or --parent-page.If your inbox is a page with child pages:
node {baseDir}/scripts/notionctl.mjs list-child-pages --page "<inbox-page-id-or-url>"node {baseDir}/scripts/notionctl.mjs triage --inbox-page "<inbox-page-id>" --rules "{baseDir}/assets/triage-rules.example.json"node {baseDir}/scripts/notionctl.mjs triage --inbox-page "<inbox-page-id>" --rules "{baseDir}/assets/triage-rules.example.json" --apply 1) export-md to read content
2) decide changes
3) append-md / create-md / move
--dry-run or omit --apply, cap scope with --limit, and only then apply.Retry-After; reduce concurrency.Generated Mar 1, 2026
Individuals use the skill to capture notes, organize research, and maintain a digital second brain. They can quickly search for meeting notes, export pages as Markdown for offline review, and triage an inbox of ideas into structured databases for long-term reference.
Writers and bloggers draft articles in Notion, using the skill to export content as Markdown for editing in other tools or to append updates. They can move pages between databases to manage editorial calendars, ensuring a streamlined workflow from ideation to publication.
Teams manage tasks by creating notes under data sources with properties like status and due dates. The skill helps triage an inbox of incoming requests, apply rules to categorize items, and move pages to appropriate project databases, improving collaboration and task tracking.
Researchers collect and annotate sources in Notion, using the skill to search for specific topics, export notes as Markdown for papers, and organize findings into databases by theme or project. This supports systematic literature reviews and data synthesis.
Support teams capture customer feedback or issues as notes in an inbox database. The skill automates triage by applying rules to move items based on content, such as urgency or category, into resolution queues, enhancing response efficiency and record-keeping.
Offer a basic version of the skill for free to individual users for personal note management, with premium features like advanced triage rules, bulk editing, and API rate limit increases for teams. Revenue comes from subscription tiers targeting small businesses and power users.
License the skill as part of a larger workflow automation platform for enterprises, integrating Notion with other tools like CRM or project management software. Revenue is generated through annual contracts, custom development, and support services for large organizations.
Provide tailored solutions using the skill to optimize Notion workflows for specific industries, such as setting up triage systems or bulk data migration. Revenue comes from one-time project fees, ongoing maintenance, and training sessions for client teams.
💬 Integration Tip
Ensure the NOTION_API_KEY is correctly set in the environment and that the integration has been shared to all relevant pages and databases to avoid 403 errors during operations.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.