notion

Manage Notion pages, databases, and blocks via the API.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/JKhyro/HERMES-AGENT --skill notion-jkhyro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/JKhyro/HERMES-AGENT/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/JKhyro/HERMES-AGENT --skill notion-jkhyro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the friction of switching between the terminal and Notion by letting you search, create, update, and organize workspace content directly through the API.

Core Features & Use Cases

  • Workspace Management: Create and update pages, databases, and blocks without leaving the command line.
  • Search and Retrieval: Find pages or databases, inspect page properties, and read block content for faster navigation.
  • Database Operations: Query data sources, create structured entries, and maintain status-driven workflows for notes or project tracking.
  • Use Case: A founder can use this Skill to keep meeting notes, task databases, and project pages synchronized from a terminal session while working across multiple contexts.

Quick Start

Use this skill to connect to your Notion workspace and create a new page called Weekly Planning in the target database.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I manage Notion pages and databases directly from the terminal?▼

You can manage Notion pages and databases from the terminal by executing curl-based HTTP requests against the Notion API. This skill handles creating, updating, and querying workspace content without requiring a browser interface.

What do I need to authenticate Notion API requests via curl?▼

Authenticating Notion API requests requires a valid Notion API token and the Notion-Version 2025-09-03 header. You must configure these credentials in your terminal environment to execute read and write operations.

Can I query Notion databases and retrieve block content using command line tools?▼

Yes, you can query Notion databases and retrieve block content using command line tools. The skill sends curl requests to search pages, inspect properties, and read structured block data for terminal-based navigation.

How does terminal-based Notion workspace management compare to using the web interface?▼

Terminal-based Notion workspace management removes the friction of switching contexts by allowing direct API manipulation of pages and blocks. It suits developers maintaining notes or project tracking workflows within a terminal session.

Are there limitations to updating Notion blocks through the API with curl?▼

Updating Notion blocks through the API with curl requires strict adherence to the Notion-Version 2025-09-03 header and valid authentication. Complex block structures may require multiple sequential API calls to manipulate correctly.