notion-hub

Perform Notion read/write operations via Python CLI using notion-client SDK.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Notion data often lives in disparate Notion workspaces and requires custom scripts to read, update, or export content. This skill provides a Python-based CLI that uses the notion-client SDK to perform end-to-end Notion operations from automation and AI workflows.

Core Features & Use Cases

  • Read and write Notion pages, databases, and blocks through a single CLI script.
  • Search, retrieve, and format Notion content for AI consumption; export pages to Markdown.
  • Create or update pages, databases, and properties, including page content and block hierarchies.
  • Manage comments and collaborate on Notion objects with programmatic controls.
  • Use cases include automation pipelines, knowledge base maintenance, and data extraction for AI prompts.

Quick Start

Install NOTION_API_KEY and run the CLI: uv run --script notion_hub.py <command> to read, search, or update Notion pages and databases.

Frequently Asked Questions about notion-hub

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

FAQPage Schema
How do I automate reading and writing Notion pages with Python?

You can automate reading and writing Notion pages with Python by using the notion-client SDK to perform programmatic CRUD operations. This skill provides a CLI script to search, retrieve, and update Notion databases and blocks from automation workflows.

Can I export Notion pages to Markdown for AI consumption?

Yes, you can export Notion pages to Markdown for AI consumption. The skill uses the notion-client SDK to retrieve and format Notion content, allowing you to extract page data and block hierarchies directly into structured text for AI prompts.

Do I need a Notion API key to manage databases via the notion-client SDK?

Yes, you need a Notion API key to manage databases via the notion-client SDK. You must install your integration token as NOTION_API_KEY before running the CLI script to authenticate read and write operations against your Notion workspace.

What's the best way to create and update Notion page properties programmatically?

The best way to create and update Notion page properties programmatically is through a CLI script using the notion-client SDK. This approach supports creating pages, updating properties, and managing block hierarchies within automation pipelines.

Does this Python CLI support managing comments and block hierarchies in Notion?

Yes, this Python CLI supports managing comments and block hierarchies in Notion. It uses the notion-client SDK to provide programmatic controls for collaborating on Notion objects and manipulating nested block structures end-to-end.

Why use a Python CLI for Notion data extraction instead of direct API calls?

Using a Python CLI for Notion data extraction abstracts direct API calls into ready-to-use scripts. It leverages the notion-client SDK to handle search, retrieval, and formatting, simplifying knowledge base maintenance and data extraction for AI workflows.