notion

Automate Notion page and database operations via the Notion API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually using Notion’s UI to create, search, update, and populate pages/databases is slow when you need repeatable workflows or automation.

Core Features & Use Cases

  • Search across pages and databases: Quickly find items by query text.
  • CRUD for pages, blocks, and databases: Create pages in databases, read page content (blocks), and update page properties.
  • Build and update content programmatically: Append blocks (e.g., paragraphs, headings, to-dos) to keep documentation and records consistent.

Example use case: Automate a task tracker by searching existing tasks, querying a database for “Active” items, and patching page status to “Done” while appending a completion note block.

Quick Start

Set your Notion API key in ~/.hermes/.env as NOTION_API_KEY, then create a new database entry by sending the appropriate curl POST request to https://api.notion.com/v1/pages using your database_id and property values.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I automate Notion page and database operations without the UI?

You can automate Notion page and database operations by sending HTTP requests to the Notion API. This approach applies to note taking, task tracking, and content publishing workflows using curl.

What do I need to query a Notion database programmatically?

To query a Notion database programmatically, you need an environment variable named NOTION_API_KEY and the Notion-Version header. These credentials authenticate your HTTP requests to access endpoints for searching and retrieving data.

Can I append blocks to an existing Notion page via the API?

Yes, you can append blocks to an existing Notion page via the API. The block insertion endpoint supports adding paragraphs, headings, and to-dos to keep your documentation and records consistent.

How do I update page properties in a Notion database?

You can update Notion page properties by sending an HTTP request to the page update endpoint. This allows you to patch statuses and modify property values while optionally appending completion note blocks.

Does this approach support searching across all my Notion pages and databases?

Yes, the Notion API supports searching across pages and databases. You can quickly find items by query text using the search endpoint to locate specific content within your Notion workspace.

What are the limitations of using curl for Notion content management?

Using curl for Notion content management requires manual HTTP request construction for each operation. You must handle authentication via the NOTION_API_KEY and include the Notion-Version header for every API call.