notion

What problem does it solve? Working with Notion programmatically requires navigating API versioning, authentication setup, database schema quirks, and platform-specific tooling. This Skill provides tested commands and documented pitfalls for reading, writing, querying, and exporting Notion content without trial-and-error. ## Core Features & Use Cases - Dual access paths: Use the official ntn CLI on macOS/Linux for one-line file uploads and Workers, or fall back to curl-based HTTP calls that work everywhere including Windows. - Full CRUD coverage: Search, read pages as Markdown, create pages from Markdown, patch content, query data sources with filters and sorts, and manage database schemas. - Notion Workers: Scaffold, deploy, and manage hosted TypeScript Workers with syncs, tools, and webhooks via ntn workers. - Workspace export: Back up an entire workspace to Markdown files with pagination handling and collision-safe naming. - Use Case: Ask the agent to create a meeting-notes page under a parent page, query a tasks database for items with Status "Active", or export your whole workspace to a local vault. ## Quick Start Set NOTION_API_KEY in your Hermes .env file, share a page with your integration, then ask the agent to read that page as Markdown or create a new page from your notes.