notion

Manage Notion pages, databases, and blocks via curl requests.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/KarlinskyS/hermesSkills --skill notion-karlinskys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/KarlinskyS/hermesSkills/tree/main/productivity/notion
Command: npx skills add https://github.com/KarlinskyS/hermesSkills --skill notion-karlinskys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill lets you operate Notion programmatically from the terminal using curl and an API key, removing the need for repetitive manual UI actions when creating, querying, or updating pages, databases, and blocks.

Core Features & Use Cases

  • Create and update pages and page content (blocks) with simple curl requests.
  • Create and query databases (data sources), set properties, and update item fields for automation and integrations.
  • Use Case: Add meeting notes to a database, query tasks by status and date, or append generated content to pages as part of scriptable workflows.

Quick Start

Use the notion skill to create a new page titled Meeting Notes in a target database by supplying the database_id and the NOTION_API_KEY in your environment.

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 pages and databases from the terminal?

To automate creating Notion pages and databases from the terminal, use curl requests with a valid NOTION_API_KEY environment variable and the Notion-Version header set for the 2025-09-03 API. This approach removes repetitive manual UI actions by sending JSON payloads directly.

What do I need to query a Notion database via curl?

Querying a Notion database via curl requires a valid NOTION_API_KEY in your environment and the Notion-Version header set for the 2025-09-03 API. You send JSON curl requests targeting the specific database_id to filter and retrieve items.

Can I append new content blocks to existing Notion pages using curl?

Yes, you can append generated content blocks to existing Notion pages using curl. By sending JSON requests with the required API key and Notion-Version header, you can update page content and append blocks as part of scriptable workflows.

Does managing Notion workspaces via the API require any specific headers?

Managing Notion workspaces via the API requires the Notion-Version header set for the 2025-09-03 API. You must also provide a valid NOTION_API_KEY environment variable when sending JSON curl requests to search, create, or update pages and data sources.

Why automate Notion workspace operations with curl instead of the UI?

Automating Notion workspace operations with curl removes the need for repetitive manual UI actions when creating, querying, or updating pages, databases, and blocks. It enables terminal-based workflows for tasks like adding meeting notes or querying tasks by status and date.