notion

Automate Notion page, database, and block operations via HTTP requests.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/eddielueng/hermes-agent-zh --skill notion-eddielueng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/eddielueng/hermes-agent-zh/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/eddielueng/hermes-agent-zh --skill notion-eddielueng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creating, searching, and updating Notion content often becomes slow or locked behind the UI when you need repeatable automation from the terminal.

Core Features & Use Cases

  • Search and read Notion content: find pages via the Notion search endpoint and fetch page properties and block children for review.
  • Create and update databases and pages: create databases (data sources), create new database entries (pages), and patch page properties.
  • Write content blocks programmatically: append paragraphs and other block types to pages to keep notes and workflows consistent.

Use case: You maintain a “Daily Log” database and want to automatically create a new entry each morning, then append the day’s summary text as blocks without clicking through the Notion interface.

Quick Start

Use the notion skill to search your workspace for pages matching a title or create a new database item by sending a curl-ready request with your NOTION_API_KEY set in ~/.hermes/.env.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I automate creating Notion database entries from the terminal?

To automate creating Notion database entries from the terminal, you use HTTP requests via curl to call the Notion API. You send a POST request to create pages and append blocks programmatically, requiring a configured Notion integration API key.

Can I append content blocks to a Notion page using curl?

Yes, you can append content blocks to a Notion page using curl. The Skill supports the blocks children endpoint, allowing you to programmatically append paragraphs and other block types to keep notes and workflows consistent without the UI.

What do I need to query Notion pages and databases via HTTP requests?

To query Notion pages and databases via HTTP requests, you need a Notion integration with an API key and the Notion-Version header. The Skill uses these to authenticate curl requests for search, page retrieval, and data source querying.

How does searching Notion content through the API work?

Searching Notion content through the API works by sending a curl request to the Notion search endpoint. This allows you to find pages matching a title, then fetch their page properties and block children for review directly from your terminal.

Is it possible to patch page properties and create databases in Notion using API automation?

Yes, it is possible to patch page properties and create databases in Notion using API automation. The Skill supports endpoints for creating new databases, adding database entries, and patching existing page properties through terminal-driven HTTP requests.

What are the limitations of terminal-driven Notion workspace automation?

Terminal-driven Notion workspace automation is limited to the endpoints and block types supported by the Notion API. It requires an active integration API key and is designed for content management and block-level publishing rather than full UI replication.