skills.rest
ossoolli
ossoolliCOMMUNITY
Explore all skills by this author →
GitHub

notion

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

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

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-specific tooling. This Skill provides ready-to-use commands for both the official ntn CLI and cross-platform curl requests so you can read, create, and update Notion content without memorizing the API surface. ## Core Features & Use Cases - Dual-path API access: Use the ntn CLI on macOS/Linux for short syntax 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 instead of raw block JSON. - Database and Worker operations: 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 your agent to create a new Notion page under your team workspace with the agenda and decisions written in Markdown, then query your tasks database for all items with Status equal to Active. ## Quick Start Use the notion skill to create a page titled "Meeting Notes" under my workspace parent page containing a Markdown summary of today's discussion.

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, title property, and a markdown body parameter containing your content. With the ntn CLI, use ntn api v1/pages with the markdown argument for the same result.

How to query a Notion database with filters?▼

POST to /v1/data_sources/{data_source_id}/query with a JSON body containing filter and sorts objects. In API version 2025-09-03, databases are called data sources and use a separate data_source_id for queries.

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.

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

The page has not been shared with your integration. Open the page menu in Notion, select Connect to, and choose your integration name so the API token can access it.

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

With ntn, run ntn files create with the file piped in. Over HTTP, it is a three-step flow: 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 Notion Workers and what plan do they require?▼

Workers are TypeScript programs hosted by Notion that expose syncs, agent tools, and webhooks. They are scaffolded and deployed with ntn workers commands and require a Business or Enterprise plan.

Related Skills

Explore More Product & Management Skills→
brikkoAIbrikkoAI
1

notion

Manages Notion workspaces by creating, reading, updating, and deleting pages, databases, and blocks.

Official
Intermediate
cploveless123cploveless123

notion

Create, read, and update Notion pages, databases, and blocks via the Notion API.

Community
Intermediate
MoneyPlugMoneyPlug

sync

Scaffolds Notion Worker sync capabilities with guided architecture, schema, and pagination design.

Community
Advanced
anxiety135790anxiety135790

notion

Automate Notion page and database management via the official API and ntn CLI.

Community
Advanced