notion

Create, read, update, and query Notion pages, databases, and blocks via CLI or REST.

Updated May 23, 2026

Search Tags:#markdown #api #cli #notion #blocks #workers #pages

Ready to run

npx skills add https://github.com/zengbaocheng/hermes-tech-hub --skill notion-zengbaocheng

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/zengbaocheng/hermes-tech-hub/tree/main/productivity/notion
Command: npx skills add https://github.com/zengbaocheng/hermes-tech-hub --skill notion-zengbaocheng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Notion exposes a programmable interface via an integration token; this skill enables developers to interact with Notion content from automation scripts and agents, eliminating repetitive manual tasks.

Core Features & Use Cases

Two access paths: the ntn CLI for quick one-liners and the HTTP API for cross-platform use.
Create, read, update, and query pages, databases (data sources), and blocks; render page content to Markdown when needed.
Workers and automations: expose tools and webhooks inside Notion to integrate workflows with Hermes agent tasks.

Quick Start

Install the Notion integration and run the preferred path (ntn CLI or HTTP) to manage pages, databases, and blocks.

Frequently Asked Questions about notion

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

FAQPage Schema

How do I automate reading and updating Notion pages via API?▼

You can automate reading and updating Notion pages via API by using a valid Notion integration token to authenticate requests. This skill enables programmatic access to query data sources, update properties, and render page content to Markdown through CLI or HTTP curl paths.

Do I need a Notion API key to create database pages from a script?▼

Yes, you need a Notion integration token (NOTION_API_KEY) and a valid Notion Version header to create database pages from a script. These credentials allow the integration to authenticate automation scripts and securely manage content across Notion workspaces.

What is the best way to query Notion databases from an automation script?▼

The best way to query Notion databases from an automation script is using the ntn CLI for quick one-liners on macOS and Linux, or the HTTP API for cross-platform compatibility. Both paths support querying data sources, reading content, and updating properties across Notion workspaces.

Can I render Notion blocks to Markdown using the CLI?▼

Yes, you can render Notion blocks to Markdown using the ntn CLI. This integration enables developers to read page content and convert blocks into Markdown format, reducing manual interactions when processing Notion data within automation scripts and agent workflows.

Does the Notion API integration support webhooks for automated workflows?▼

Yes, the Notion API integration supports webhooks for automated workflows. It exposes tools and webhooks inside Notion to integrate workflows with Hermes agent tasks, allowing you to automate reading page content, updating properties, and querying data sources across workspaces.