skills.rest
igniteenow
igniteenowCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

notion

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

16|Updated Sep 22, 2026
Search Tags:#markdown#API#productivity#database#Workers#cli#Notion
One-click install
npx skills add https://github.com/igniteenow/robo --skill notion-igniteenow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/igniteenow/robo/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/igniteenow/robo --skill notion-igniteenow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires juggling API versioning, block JSON structures, file upload flows, and platform differences between the ntn CLI and raw curl requests. This Skill consolidates both paths into one operational guide so an agent can read, write, search, and query Notion content without trial and error. ## Core Features & Use Cases - Dual-path operation: Uses the official ntn CLI on macOS/Linux and falls back to cross-platform HTTP + curl on Windows, with runtime detection of which path is available. - Full API coverage: Search, page CRUD, markdown read/write endpoints, database (data source) queries with filters and sorts, typed property updates, block appending, and file uploads. - Notion Workers: Scaffold, deploy, and manage TypeScript Workers exposing syncs, agent tools, and webhooks hosted by Notion. - Use Case: Ask the agent to create a meeting-notes page under a parent page with markdown content, 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 pages with your Notion integration, then ask the agent to search Notion for a page and read it 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?▼

POST to /v1/pages with a parent page_id, a title property, and a markdown body parameter containing your content. With the ntn CLI, run ntn api v1/pages with inline parent, properties, and markdown fields.

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 Workers, but runs only on macOS and Linux. The HTTP API with curl works everywhere 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. 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 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, plus optional sorts. Complex queries can be piped as JSON to ntn.

Can I use the ntn CLI on Windows?▼

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

What are the limitations of Notion Workers?▼

Deploying Workers requires a Notion Business or Enterprise plan and the ntn CLI on macOS or Linux. Workers are free through August 11, 2026, then metered on Notion credits.

Related Skills

Explore More Product & Management Skills→
taracodlabstaracodlabs
779

notion

Manage Notion pages and databases via the Notion REST API.

Official
Intermediate
swcstudiospaceswcstudiospace

notion

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

Official
Advanced
globalmsqglobalmsq

moai-connector-notion

Automate Notion page and database operations within MCP-enabled workflows.

Official
Advanced
cris-mcris-m

notion

Automate Notion page and database operations via MCP tools with API fallback.

Community
Advanced