skills.rest
zengbaocheng
zengbaochengCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/zengbaocheng/hermes-tech-hub --skill notion-zengbaocheng
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
anilcan-karaanilcan-kara

notion

Interact with Notion via ntn CLI or HTTP APIs using one token.

Community
Intermediate
samlaggzsamlaggz

webhook-subscriptions

Subscribe external services to Hermes webhooks to trigger agent runs.

Community
Intermediate
archview-aiarchview-ai

openwebf-host

Route WebF host requests to focused OpenWebF skills by trigger terms.

Official
Advanced
InverterNetworkInverterNetwork

notion

Manage Notion pages, query databases, and deploy custom workers via CLI or REST API.

Official
Advanced