skills.rest
loteiron
loteironCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

notion

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

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

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, creating, and updating Notion pages and databases through either the official ntn CLI or cross-platform curl requests. ## Core Features & Use Cases - Dual-path API access: Use the ntn CLI on macOS/Linux for shorthand commands 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 using the /markdown endpoints. - Database operations: Query data sources with filters and sorts, create databases with typed properties, and update page properties like Status and Date. - Notion Workers: Scaffold, deploy, and manage TypeScript Workers that expose syncs, agent tools, and webhooks hosted by Notion. - Use Case: After a meeting, ask the agent to create a Notion page titled "Notes from meeting" under a parent page with the agenda and decisions written in Markdown, then query your tasks database for all items with Status "Active". ## 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 your notes.

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 parameter containing your content. With the ntn CLI, use ntn api v1/pages with inline parent, properties, and markdown fields.

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 filter such as a Status select equals condition, plus optional sorts. Complex queries can be piped as JSON to ntn api with --json -.

ntn CLI vs curl for the Notion API, which should I use?▼

Use the ntn CLI on macOS or Linux for shorter syntax, one-line file uploads, and Workers deployment. Use curl with the HTTP API on Windows or anywhere ntn is not installed; both paths use the same integration token.

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 even with a valid token.

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.

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. Querying requires the data_source_id while creating pages in a database uses the database_id as the parent.

Related Skills

Explore More Product & Management Skills→
jakubbartnikjakubbartnik

notion

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

Community
Intermediate
dallaydallay

notion-knowledge-capture

Convert chat transcripts and meeting notes into structured Notion pages and database records.

Official
Intermediate
FelipePepeFelipePepe

copilot-sdk

Orchestrate tools and sessions for embedded AI agents via the Copilot SDK.

Community
Advanced
lumincuilumincui

obsidian-todoist-sync

Synchronize Todoist tasks into Obsidian vaults using an API token.

Community
Intermediate