notion

Create, search, update, and query Notion pages and databases via curl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the friction of managing Notion content manually by giving you a direct, repeatable way to create and update pages, databases, and blocks through the Notion API.

Core Features & Use Cases

  • Search pages and databases to quickly locate content by title or keywords.
  • Create and query databases (data sources) to insert records and fetch results using filters and sorts.
  • Read and write blocks to retrieve page content and append new block content programmatically.
  • Use Case: Keep a task database in Notion and use the skill to add new tasks, query active tasks sorted by date, and append updates to a page’s content.

Quick Start

Tell Hermes: “Use the notion skill to search for pages matching ‘Project Apollo’ and return the key properties for the top results.”

Frequently Asked Questions about notion

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

FAQPage Schema
How do I automate creating and updating Notion pages via the API?

You can automate Notion API interactions by sending curl requests to create, search, update, and query pages and databases. This requires a valid NOTION_API_KEY and the Notion-Version header 2025-09-03 to manage productivity workflows like task databases.

Can I query Notion databases using filters and sorts with curl?

Yes, you can query Notion databases by sending curl requests with specific filter and sort parameters. This allows you to fetch records from data sources, insert new entries, and sync structured records between Notion and external systems programmatically.

What do I need to read and append blocks in Notion programmatically?

To read and write Notion blocks programmatically, you need a valid NOTION_API_KEY and must send curl requests using the correct endpoint patterns for blocks. This lets you retrieve page content and append new block content directly.

Does the Notion API support searching for pages by title or keywords?

Yes, the Notion API supports searching pages and databases by title or keywords. By sending a curl request, you can quickly locate content and return key properties for the top results matching your search terms.

How do I sync structured records between Notion and external systems?

You can sync structured records between Notion and external systems by using curl to automate API queries and updates. This involves applying correct endpoint patterns to create, update, and fetch database records across connected platforms.

Are there limitations when using curl to manage Notion database records?

When using curl to manage Notion database records, you must include the exact Notion-Version header 2025-09-03 and a valid NOTION_API_KEY. Operations depend on correct endpoint patterns for blocks, pages, and data_sources queries to avoid request failures.