notion

Manage Notion pages, databases, and blocks via the REST API with curl.

19|4|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill notion-carterwayneskhizeine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill notion-carterwayneskhizeine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of creating and updating Notion content without relying on the Notion UI or higher-level SDKs, so you can automate workflows from the command line.

Core Features & Use Cases

  • Notion CRUD via curl: Create, read, update pages, database items, and block content using raw HTTP requests.
  • Search and data-source querying: Find pages and query database “data sources” to retrieve structured results for your workflow.
  • Blocks and database property control: Add and update page properties and append blocks like paragraphs, headings, lists, calls, and more.

Quick Start

Tell your AI to use curl with your NOTION_API_KEY to search for a page titled “Team Notes” and return the page’s properties 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 Notion content management using curl from the command line?

Automate Notion content management by using curl to send HTTP requests to the Notion REST API for creating, reading, and updating pages and database items directly from terminal scripts.

What do I need to query Notion databases and pages via the REST API?

Querying Notion databases and pages requires an Authorization Bearer token and a Notion-Version header passed in your curl command to authenticate requests to endpoints like /v1/search and /v1/data_sources/{id}/query.

Can I append blocks and update page properties in Notion without using an SDK?

Yes, you can append blocks like paragraphs, headings, and lists, or update page properties by sending raw HTTP requests via curl to the /v1/pages and /v1/blocks endpoints.

What is the best way to search for specific Notion pages from a terminal workflow?

The best way to search for Notion pages from a terminal workflow is using the /v1/search endpoint with curl, allowing you to find pages by title and retrieve structured results without the Notion UI.

Does automating Notion with curl work for updating database data sources?

Yes, automating Notion with curl works for database data sources by querying structured items through the /v1/data_sources/{id}/query endpoint and updating specific properties as needed.

Why use raw curl requests instead of a higher-level SDK for Notion automation?

Use raw curl requests instead of a higher-level SDK to remove dependency overhead, enabling lightweight Notion automation directly from scripts or terminal workflows without installing additional packages.