notion

Create, read, update, and search Notion pages, databases, and blocks via the API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the friction of manually managing Notion content by letting you create, find, update, and read pages, databases, and blocks directly through the Notion API.

Core Features & Use Cases

  • Search and Retrieval: Find pages or database entries and inspect their properties or block content.
  • Content Creation and Updates: Create pages, add blocks, update page properties, and build structured Notion databases.
  • Practical Workflow: Use it to maintain project trackers, notes, task boards, or documentation pages from simple API requests instead of clicking through the Notion UI.

Quick Start

Use the notion skill to connect your Notion integration key and ask it to search for a page, create a database item, or append content to an existing page.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I query Notion databases using curl?

You can query Notion databases via curl by sending POST requests with your integration API key and the Notion-Version 2025-09-03 header to filter and retrieve database entries based on specified properties.

Can I create Notion pages and append blocks via the API?

Yes, you can create Notion pages and append blocks via the API by sending curl requests with the required integration API key and database or page IDs to structure your content.

Do I need an API key to manage Notion content through curl requests?

Yes, managing Notion content through curl requests requires a Notion integration API key and the Notion-Version 2025-09-03 header to authenticate and execute read, update, and search operations successfully.

What's the best way to update Notion page properties without the UI?

The best way to update Notion page properties without the UI is using curl API requests, which require your integration API key, the Notion-Version 2025-09-03 header, and the target page ID to patch property values.

Are there limitations when searching for Notion records via curl?

Limitations when searching for Notion records via curl include respecting specific database and data source IDs in your requests, and ensuring the Notion-Version 2025-09-03 header is correctly applied for accurate results.