skills.rest
swcstudiospace
swcstudiospaceOFFICIAL
Explore all skills by this author →
Website𝕏@govantarcticaGitHub

notion

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires navigating API versioning, authentication setup, block-level JSON structures, and platform-specific tooling differences. This Skill provides ready-to-use commands for both the official ntn CLI and cross-platform curl-based HTTP access, so you can read, create, and update Notion content without memorizing endpoint details. ## 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 curl with the Notion HTTP API on any platform including Windows. - Page and database operations: Search workspaces, read pages as Markdown or block JSON, create and patch pages from Markdown, and query data sources with filters and sorts. - Notion Workers: Scaffold, deploy, and manage TypeScript Workers that host syncs, agent tools, and webhooks on Notion's infrastructure. - Use Case: After a team meeting, ask the agent to create a new Notion page under your notes parent page containing the meeting agenda and decisions written in Markdown, then query your tasks database for all items with Status equal to Active. ## Quick Start Set your NOTION_API_KEY environment variable and ask the agent to search your Notion workspace for a page and read its contents 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 using the API?▼

Send a POST request to /v1/pages with a parent page_id, title property, and a markdown body field containing your content. With the ntn CLI installed, use ntn api v1/pages with inline key=value parameters for the same result.

How do I query a Notion database with filters?▼

Query a database by POSTing 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 supports macOS and Linux only, with Windows support not yet available. Windows users can use the curl-based HTTP API path directly, or install ntn inside WSL2 for CLI ergonomics.

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

A 404 occurs when the page has not been shared with your integration. Open the page menu in Notion, select Connect to, and add your integration name so the API token can access that page.

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

With ntn, run ntn files create with the file piped to stdin for a one-step upload. Over HTTP, follow 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?▼

Notion Workers are TypeScript programs hosted by Notion that expose syncs, agent tools, and webhooks. The CLI works on all plans, but deploying Workers requires a Business or Enterprise plan and the ntn CLI on macOS or Linux.

Related Skills

Explore More Product & Management Skills→
taracodlabstaracodlabs
779

notion

Manage Notion pages and databases via the Notion REST API.

Official
Intermediate
josoromajosoroma
6

notion

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

Community
Intermediate
globalmsqglobalmsq

moai-connector-notion

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

Official
Advanced
onymchatonymchat

swiftui-webkit

Embed and control web content in SwiftUI apps using WebView and WebPage APIs.

Official
Advanced