notion

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

1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux --skill notion-iceheartgith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux/tree/main/custom-skills/productivity/notion
Command: npx skills add https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux --skill notion-iceheartgith

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 authentication setup. This Skill provides ready-to-use commands for reading, writing, searching, and querying Notion content through either the official ntn CLI or plain curl requests. ## Core Features & Use Cases - Dual access paths: Use the ntn CLI on macOS/Linux for short syntax and one-line file uploads, or fall back to cross-platform HTTP + curl requests that work everywhere including Windows. - Page and database operations: Search workspaces, read pages as Markdown or blocks, 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 inside Notion. - 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 equal to Active. ## Quick Start Set your NOTION_API_KEY environment variable and ask the agent to create a Notion page titled Meeting Notes with 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 page_id, a title property, and a markdown body parameter containing your content. With the ntn CLI installed, run ntn api v1/pages with the same fields as inline arguments.

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 Notion Workers, 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.

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.

Can I use the ntn CLI on Windows?▼

Native Windows support for ntn is not available as of May 2026. Windows users can either use the curl-based HTTP path directly or install ntn inside WSL2 to get CLI ergonomics and Workers support.

What are the limitations of the Notion API for databases?▼

The API cannot set database view filters, which remain UI-only. Rate limits average about 3 requests per second, and in API version 2025-09-03 databases are queried as data sources using a separate data_source_id.