skills.rest
luckybbjason1
luckybbjason1COMMUNITY
Explore all skills by this author →
GitHub

notion

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

Updated Sep 9, 2026
Search Tags:#markdown#productivity#database#api#cli#notion#workers
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill notion-luckybbjason1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/productivity/notion
Command: npx skills add https://github.com/luckybbjason1/trading --skill notion-luckybbjason1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires juggling API versions, block JSON structures, file upload flows, and platform differences between the ntn CLI and raw HTTP. This Skill provides ready-to-use commands for both paths so you can read, create, and update Notion content without memorizing the API surface. ## Core Features & Use Cases - Dual-path operation: Use the official ntn CLI on macOS/Linux or fall back to curl-based HTTP calls that work everywhere including Windows. - Full content workflow: 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: Scaffold, deploy, and manage hosted TypeScript Workers with syncs, tools, and webhooks (Business/Enterprise plans). - 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 filtered by Status equals Active and sorted by Date descending. ## Quick Start Set NOTION_API_KEY in your environment, share the target page with your integration, then ask the agent to read a Notion page as Markdown or create a new page from Markdown content.

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, use ntn api v1/pages with inline key=value parameters including the markdown field.

How do I 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 JSON body containing filter and sorts clauses. For complex queries, pipe JSON into ntn api with the --json - flag.

Does the ntn CLI work on Windows?▼

No, ntn is macOS and Linux only as of May 2026, with Windows support announced as coming soon. Windows users can use the curl-based HTTP path directly or install ntn inside WSL2.

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; without this step the API cannot see the page.

How do I upload files to Notion through the API?▼

With ntn, run ntn files create with the file on stdin for a one-step upload. Over HTTP it takes three steps: create a file_upload, PUT the bytes to the returned upload_url, then reference the file_upload_id in a page or block payload.

What are the limitations of Notion Workers?▼

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

Related Skills

Explore More Product & Management Skills→
zhoulingxiao1216zhoulingxiao1216

notion

Manage Notion pages, databases, and blocks via the Notion API using curl.

Community
Intermediate
hmzainjamilhmzainjamil
1

notion-automation

Automate Notion database updates, page creation, and workflow syncs.

Community
Advanced
thecloudtipsthecloudtips
18

Notion Operations

Manage Notion pages and databases via Notion MCP tools.

Community
Advanced
p-sree-sai-pavanp-sree-sai-pavan
5

notion

Manage Notion pages, databases, and blocks from the command line.

Community
Advanced