notion-cli

What problem does it solve? Working with the Notion API from an agent or terminal requires knowing exact endpoint syntax, request shapes, and several non-obvious traps (full-replace page updates, data source IDs, typed body parameters). This Skill teaches the self-documenting ntn CLI so tasks like creating pages, querying databases, uploading files, and deploying workers succeed on the first attempt. ## Core Features & Use Cases - API discovery and calls: List endpoints, read docs and OpenAPI fragments, and issue GET/POST requests with correct argument order and typed := body fields. - Page and database operations: Create and update pages with Markdown content, create databases with initial data sources, and add rows against the correct data source ID. - Files and workers: Upload files via the File Uploads API wrapper and scaffold, deploy, list, and execute Notion workers. - Trap avoidance: Built-in guidance for full-replace updates on pages with children, non-interactive --yes confirmation, slow large-page updates, and safe trash-and-recreate ordering. - Use Case: Ask the agent to create a Notion database under a parent page, populate it with rows that have Markdown bodies, and attach an uploaded image, all through ntn commands. ## Quick Start Ask the agent to use the ntn CLI to create a new Notion page under a given parent page with Markdown content, after setting the NOTION_API_TOKEN environment variable.