notion

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill notion-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill notion-chensihakniroth

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 platform-specific tooling. This Skill provides ready-to-use commands for reading, writing, searching, and querying Notion content through either the official ntn CLI or cross-platform curl requests. ## Core Features & Use Cases - Dual-path API access: Use the ntn CLI on macOS/Linux for shorthand commands and one-line file uploads, or fall back to HTTP + curl on any platform including Windows. - Markdown-native workflows: Read pages as agent-friendly Markdown and create or patch pages directly from Markdown content using the 2025-09-03 API version. - Database and Worker support: 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 with the agenda and decisions formatted in Markdown, then query your tasks database for all items with Status equals Active. ## Quick Start Use the notion skill to create a page titled "Meeting Notes" under my team page with the agenda I paste here.

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 parameter containing your content. With the ntn CLI, use ntn api v1/pages with inline parent, properties, and markdown fields.

How to query a Notion database with filters?▼

In API version 2025-09-03, databases are data sources, so POST to /v1/data_sources/{data_source_id}/query with a filter object such as property Status select equals Active. Complex queries with sorts can be piped as JSON via the ntn CLI.

Does the ntn CLI work on Windows?▼

The ntn CLI is macOS and Linux only as of May 2026, with Windows support planned. Windows users can use the curl-based HTTP path directly or install ntn inside WSL2 for CLI ergonomics.

Why does the Notion API return 404 for an existing page?▼

A 404 occurs when the page has not been shared with your integration. In Notion, open the page menu, select Connect to, and choose your integration name so the API token gains access.

What are Notion Workers and what plan do they require?▼

Notion Workers are hosted TypeScript programs exposing syncs, agent tools, and webhooks, deployed via ntn workers deploy. Deploying Workers requires a Notion Business or Enterprise plan, though the CLI itself works on all plans.

What is the Notion API rate limit?▼

The Notion API allows roughly 3 requests per second on average, and the ntn CLI does not bypass this limit. Batch operations and avoid tight loops when processing many pages or blocks.