skills.rest
TylerSimons1127
TylerSimons1127COMMUNITY
Explore all skills by this author →
GitHub

notion

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

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

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 access paths: Use the ntn CLI on macOS/Linux for shorthand 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 operations and Workers: 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 written in Markdown, then query your tasks database for all items with Status equals Active. ## Quick Start Set your NOTION_API_KEY environment variable and ask the agent to search Notion for a page titled "Meeting Notes" and summarize its contents.

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 the same fields in shorthand syntax.

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

The ntn CLI offers shorter syntax, one-line file uploads, and Worker deployment, but 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.

Does the Notion API work on Windows?▼

Yes, the HTTP API works on Windows using the built-in curl or PowerShell Invoke-RestMethod. The ntn CLI is macOS and Linux only, though Windows users can run it 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, select Connect to, and choose your integration name so the API token gains access.

What is the difference between database_id and data_source_id in Notion?▼

In API version 2025-09-03, databases became data sources with two IDs. Use database_id as the parent when creating pages, and data_source_id when querying via POST /v1/data_sources/{id}/query.

What are the limitations of Notion Workers?▼

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

Related Skills

Explore More Product & Management Skills→
maopujie10-sysmaopujie10-sys
1

notion

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

Community
Intermediate
kbtimekbtime

Notion

Read and write Notion pages and databases via the REST API.

Community
Intermediate
davila7davila7
30.5k

notion-meeting-intelligence

Prepares meeting agendas and pre-reads using Notion context and Codex research.

Community
Intermediate
AjayRajan05AjayRajan05
5

notion

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

Community
Advanced