notion

Create and manage Notion pages, databases, and blocks via curl.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill notion-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/productivity/notion
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill notion-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a simple, curl-based way to create, read, update, and query Notion pages, databases (data sources), and blocks so users can automate content workflows without the Notion UI.

Core Features & Use Cases

  • Programmatic search and retrieval of pages and data sources using the Notion search and data_sources endpoints.
  • Create pages in databases, create data sources (databases), update page properties, and append blocks to pages via HTTP requests.
  • Use Case: Automate importing rows from a CSV into a Notion database, update task statuses from an external system, or append audit logs to pages for engineering reports.

Quick Start

Set your NOTION_API_KEY in your environment, ensure the integration is shared with the target page or data source, and use the provided curl examples to create or query content.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I create Notion pages and databases from the terminal?

You can create Notion pages and databases from the terminal by sending curl-based HTTP requests to the Notion REST API, requiring a valid integration API key and the correct Notion-Version header.

What is the best way to automate updating Notion pages without the UI?

Automating Notion page updates without the UI is best done via curl-based HTTP requests to the Notion REST API, allowing you to programmatically update page properties and append blocks.

Can I query Notion databases and pages using curl?

Yes, you can query Notion databases and pages using curl by sending HTTP requests to the Notion search and data_sources endpoints to programmatically retrieve and filter content.

Why does my Notion API request fail when creating a page in a database?

Notion API requests fail when creating pages if the target database is not shared with your integration, or if the NOTION_API_KEY and Notion-Version header are missing or incorrect.

Does this approach support appending blocks to existing Notion pages via the API?

Yes, this approach supports appending blocks to existing Notion pages via the API by sending HTTP requests to append block children, which is useful for adding audit logs or engineering reports.