notion

Manage Notion pages, databases, and Workers via the ntn CLI or HTTP API.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill notion-jakubbartnik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/jakubbartnik/honey-barrel-finale/tree/main/honey-barrel-finale/workspace/hermes/skills/productivity/notion
Command: npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill notion-jakubbartnik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires juggling API versions, authentication tokens, block JSON structures, and multi-step file uploads. This Skill provides ready-to-use commands for both the official ntn CLI and plain curl, so you can read, create, and update Notion content without memorizing the API surface. ## Core Features & Use Cases - Dual-path API access: Use the ntn CLI on macOS/Linux for short commands and one-line file uploads, or fall back to curl with the Notion HTTP API on any platform including Windows. - Markdown-native workflows: Read pages as Markdown for agent consumption and create or patch pages directly from Markdown content instead of raw block JSON. - Database queries and Workers: Query data sources with filters and sorts, manage typed properties, and deploy Notion Workers for syncs, webhooks, and agent tools. - Use Case: After a meeting, ask the agent to create a new Notion page under your team workspace containing the meeting notes in Markdown, then query your tasks database for all items with Status equals Active. ## Quick Start Set NOTION_API_KEY in your environment, share a page with your integration, then ask the agent to read a Notion page as Markdown or create a new page from your notes.

Frequently Asked Questions about notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Notion page from Markdown using the API?▼

Send a POST request to /v1/pages with a parent page_id, title property, and a markdown body field containing your content. With the ntn CLI installed, run ntn api v1/pages with the same fields as inline arguments for a shorter command.

How do I query a Notion database with filters?▼

POST to /v1/data_sources/{data_source_id}/query with a JSON body containing filter and sorts objects. In API version 2025-09-03, databases are called data sources, so use the data_source_id rather than the database_id for queries.

What is the difference between the ntn CLI and the Notion HTTP API?▼

The ntn CLI offers shorter syntax, one-line file uploads, and is required for deploying Notion Workers, but runs only on macOS and Linux. The HTTP API with curl works on every platform including Windows and covers the same page and database operations.

Why does the Notion API return 404 for a page that exists?▼

The page has not been shared with your integration. Open the page menu in Notion, select Connect to, and choose your integration name. Without this step the API cannot see the page even with a valid token.

Can I use the ntn CLI on Windows?▼

Native Windows support is not available as of May 2026. Use the curl-based HTTP path directly on Windows, or install ntn inside WSL2 if you want the CLI ergonomics and Workers deployment features.

What are the limitations of the Notion API for databases?▼

The API cannot set database view filters, which remain UI-only. Rate limits average about 3 requests per second, and the ntn CLI does not bypass this limit.