notion

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

6|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/josoroma/AppLoop --skill notion-josoroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/josoroma/AppLoop/tree/main/.hermes/skills/productivity/notion
Command: npx skills add https://github.com/josoroma/AppLoop --skill notion-josoroma

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 access paths: 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 using the /markdown endpoints. - Database operations: Query data sources with filters and sorts, create databases with typed properties, and update page properties like Status or Date. - Notion Workers: Scaffold, deploy, and manage hosted TypeScript Workers that run syncs, expose agent tools, and receive webhooks. - Use Case: After a meeting, ask the agent to create a 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 the target page with your integration, then ask the agent to create a Notion page titled Meeting Notes with a Markdown agenda under a given parent page.

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 via the API?▼

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

How do I query a Notion database with filters?▼

In API version 2025-09-03, databases are queried as data sources via POST /v1/data_sources/{data_source_id}/query with a JSON filter and optional sorts. Note the database_id is used for creating pages while the data_source_id is used for querying.

Should I use the ntn CLI or curl for the Notion API?▼

Use ntn on macOS or Linux for shorter syntax, one-line file uploads, and Workers support. Use curl with the HTTP API on Windows or anywhere ntn is not installed; both paths use the same integration token.

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

The page has not been shared with your integration. In Notion, open the page menu, choose Connect to, and select your integration name; the API only sees content explicitly shared with it.

Can I use the ntn CLI on Windows?▼

Native ntn is macOS and Linux only as of May 2026, with Windows support planned. Windows users can run ntn inside WSL2 or use the curl-based HTTP API path, which works with the curl shipped in Windows 10+.

What are the limitations of Notion Workers?▼

Deploying Workers requires a Notion Business or Enterprise plan and the ntn CLI, so Windows users need WSL2. Workers are free through August 11, 2026, after which usage is metered on Notion credits.