notion-hub

Read and write Notion pages, databases, blocks, and comments via the Notion API.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/riipandi/minis-skills --skill notion-hub-riipandi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-hub
Source: https://github.com/riipandi/minis-skills/tree/main/notion-hub
Command: npx skills add https://github.com/riipandi/minis-skills --skill notion-hub-riipandi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires notion-client, httpx, and includes scripts (resource) components.

What problem does it solve? Managing Notion content programmatically requires handling the Notion API's block-based structure, pagination, and property schemas. This Skill provides a single CLI that performs search, page CRUD, database queries, block operations, and comments with Markdown-to-block conversion. ## Core Features & Use Cases - Page Operations: Read pages as Markdown, create pages, write Markdown content with automatic block conversion, and update properties or icons. - Database Management: Inspect schemas, query rows with filters and sorts, add rows with auto-detected property types, and create new databases. - Block & Comment Control: Append, update, and delete individual blocks, recursively fetch page trees, and manage comment threads. - Use Case: Ask the assistant to find your "Meeting Notes" database in Notion, query all rows where Status is "In Progress", and append a summary paragraph to the top result page. ## Quick Start Search my Notion workspace for the page titled "Project Plan" and read its full content as Markdown.

Frequently Asked Questions about notion-hub

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read a Notion page as Markdown in Python?

Use the page-read command with a page ID or Notion URL to get the full page content converted to Markdown. The script recursively fetches blocks up to a configurable depth and converts headings, lists, code blocks, and tables into Markdown syntax.

How do I add a row to a Notion database with the API?

Use the db-add-row command with the database ID and a JSON props object mapping property names to simple values. The script auto-detects each property type from the database schema, so you can pass plain strings, numbers, booleans, or dates.

What permissions does a Notion integration need to access pages?

The integration must be explicitly connected to each target page or database through the Notion UI under Share, then Connections. Without this connection, API calls return 403 or 404 errors even with a valid NOTION_API_KEY token.

Why does the Notion API return a 401 or 403 error?

A 401 error means the NOTION_API_KEY token is invalid or expired and must be regenerated at notion.so/my-integrations. A 403 error means the integration is not connected to the target page or database in the Notion UI.

Can I query a Notion database with filters and sorting?

Yes, the db-query command accepts Notion filter JSON for properties like status, select, date, and checkbox, plus compound and/or conditions. Sorts are passed as a JSON array specifying property and direction, with automatic pagination and an optional result limit.