notion

Create, query, and update Notion pages and databases via the Notion API and ntn CLI.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill notion-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/skills/productivity/notion
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill notion-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires navigating API versioning, authentication, block 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 - Page and Database Operations: Search, read, create, and patch pages, query data sources with filters and sorts, and manage typed database properties. - Markdown Workflows: Read pages as agent-friendly Markdown and create or update pages directly from Markdown content using Notion-flavored Markdown extensions. - File Uploads and Workers: Upload files via one-line CLI commands or the 3-step HTTP flow, and scaffold, deploy, and manage Notion Workers for syncs, tools, and webhooks. - 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 Use the notion skill to create a page titled "Meeting Notes" under my workspace 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 page_id, title property, and a markdown body parameter containing your content. With the ntn CLI installed, use ntn api v1/pages with inline parent, properties, and markdown fields for shorter syntax.

How do I query a Notion database with filters?▼

Query a database by sending a POST request to /v1/data_sources/{data_source_id}/query with a JSON filter object, such as a select property equals condition. In API version 2025-09-03, databases are called data sources and use the data_source_id for queries.

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

The ntn CLI offers shorter syntax, typed assignments, and one-line file uploads, but runs only on macOS and Linux. Curl works everywhere including Windows and is the default fallback when ntn is not installed; both use the same integration token.

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

A 404 occurs when the page or database has not been shared with your integration. In Notion, open the page menu, select Connect to, and choose your integration name to grant access before calling the API.

Can I use the ntn CLI on Windows?▼

Native ntn support for Windows is not yet available as of May 2026. Windows users can use the curl-based HTTP path directly, or install ntn inside WSL2 to get the 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, and enforces a rate limit of roughly 3 requests per second. Databases also have two IDs: database_id for creating pages and data_source_id for querying.