skills.rest
perasyudha
perasyudhaCOMMUNITY
Explore all skills by this author →
Website𝕏@Nyxora_AIGitHub

notion

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

5|2|Updated May 26, 2026
Search Tags:#markdown#productivity#database#api#cli#notion#workers
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill notion-perasyudha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/productivity/notion
Command: npx skills add https://github.com/perasyudha/Nyxora --skill notion-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires juggling API versions, authentication headers, block JSON structures, and multi-step file uploads. This Skill gives an AI agent ready-to-use commands for reading, writing, searching, and querying Notion content through either the official ntn CLI or plain curl, with the API key already injected into the environment. ## Core Features & Use Cases - Dual execution paths: Uses the ntn CLI on macOS/Linux for short syntax and one-line file uploads, with automatic fallback to curl + the Notion HTTP API on any platform including Windows. - Full content operations: Search workspaces, read pages as Markdown or blocks, create and patch pages from Markdown, query data sources with filters and sorts, and upload files. - Notion Workers support: Scaffold, deploy, and manage hosted TypeScript Workers that run syncs, expose agent tools, and receive webhooks. - Use Case: Ask the agent to create a meeting-notes page under a parent page with an agenda in Markdown, then query a tasks database for all items with Status equals Active sorted by date. ## Quick Start Ask the agent to search your Notion workspace for a page by title and read its contents as Markdown.

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, 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?▼

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 object, for example matching a Status select property. You can also add sorts clauses for ordering results.

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

The ntn CLI offers shorter syntax, typed assignments, and one-line file uploads, and it is required for deploying Notion Workers, but it 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?▼

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

Can I use the ntn CLI on Windows?▼

Native Windows support for ntn is not yet available as of May 2026. Windows users can either use the curl-based HTTP API path, which works fully, or install ntn inside WSL2 for CLI ergonomics and Workers deployment.

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

The API cannot set database view filters, which remain UI-only, and rate limits average about 3 requests per second. Queries must use the data_source_id while page creation under a database uses the database_id.

Related Skills

Explore More Product & Management Skills→
BermudaLocalsBermudaLocals
1

notion

Manage Notion pages, databases, and blocks via curl API calls.

Community
Intermediate
AstrumonAstrumon

notion-content-reader

Fetch and search Notion pages, databases, and records via MCP workflows.

Community
Intermediate
robomotioniorobomotionio
2

notion

Manage Notion pages and databases via CLI with JSON outputs.

Official
Advanced
InverterNetworkInverterNetwork

notion

Manage Notion pages, query databases, and deploy custom workers via CLI or REST API.

Official
Advanced