notion
Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.
Security Assessment
Detected risks:
About notion
The Notion skill provides comprehensive command-line interface and API access to Notion's workspace management platform. It enables developers and technical users to interact with Notion pages, databases, files, and content programmatically without relying on the web interface. By leveraging the official `ntn` CLI tool or direct API calls via curl, users can automate document creation, query databases, manage content, and integrate Notion into their development workflows and CI/CD pipelines.
The skill offers markdown-first operations for page management, allowing users to create, read, update, and trash pages using familiar markdown syntax. It supports data source queries with filtering and sorting capabilities, file uploads (both direct and external URLs), search functionality, comment management, and Worker deployment for serverless automation. The CLI handles authentication automatically through login credentials or environment tokens, and provides introspection tools to explore API endpoints, view specifications, and access documentation directly from the terminal.
Target users include developers building integrations with Notion, DevOps engineers automating documentation workflows, content managers handling bulk operations, and technical writers maintaining knowledge bases. The skill is particularly valuable for teams that need to synchronize Notion content with external systems, generate reports from Notion databases, automate page creation from templates or CI/CD outputs, and manage workspace content at scale. Both interactive and headless authentication modes support both local development and automated deployment scenarios.
FAQ
What's the difference between using `ntn` CLI and curl for Notion API calls?
The official `ntn` CLI is preferred because it handles authentication and API versioning automatically, provides markdown-first page operations, and includes introspection tools like `--help`, `--spec`, and `--docs`. Use curl only when `ntn` is unavailable or when making raw requests is clearer for your specific use case.
How do I authenticate for automated scripts or CI/CD pipelines?
Set the `NOTION_API_TOKEN` environment variable with your integration token or user token. The CLI will automatically use this token instead of interactive login. Also set `NOTION_API_VERSION` to specify the API version (currently `2026-03-11`).
What's the difference between databases and data sources?
Databases can contain multiple data sources. When creating pages or querying content, you typically work with data source IDs rather than database IDs. Use `ntn datasources resolve <database-id>` to convert a database ID to its data source representation.
Can I use markdown files to create Notion pages?
Yes, the `pages` commands are markdown-first. You can pipe markdown files via stdin (`< page.md`), use the `--content` flag with markdown strings, or let the CLI open your editor in TTY mode. Page properties are represented as frontmatter in the markdown output.
Do Notion Workers require a specific plan level?
Yes, Workers may require a Business or Enterprise plan and must be enabled at the workspace level. Check your workspace settings and plan details before attempting to deploy Workers.
Install notion
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
steipete/clawdis