skills.rest
kaminocorp
kaminocorpOFFICIAL
Explore all skills by this author →
Website𝕏@kaminocorpoGitHub

notion

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

1|Updated Mar 12, 2026
Search Tags:#productivity#database#api#notion#notes#curl#pages
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill notion-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill notion-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion workspaces from the terminal normally requires SDKs or manual UI clicks. This Skill lets you search, create, update, and query Notion pages, databases, and blocks directly with curl and a Notion API key, with no extra tooling required. ## Core Features & Use Cases - Full CRUD via curl: Search workspaces, get pages and block content, create pages in databases, query data sources with filters and sorts, and update page properties. - Database management: Create databases (data sources) with typed properties such as select, date, relation, and checkbox, using the 2025-09-03 API version. - Rich block authoring: A reference guide covers every common block type (headings, lists, to-dos, code, callouts, toggles, images) for both writing and reading page content. - Use Case: Ask the agent to add a new task to your Notion project tracker with a status and due date, then append a summary paragraph to the page — all from the terminal. ## Quick Start Set NOTION_API_KEY in ~/.hermes/.env, share your target pages with the integration, then ask the agent to create a new page in your Notion database with a title and status.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I create a page in a Notion database with the API?▼

Send a POST request to https://api.notion.com/v1/pages with the parent database_id and a properties object containing the title and other fields. Include the Authorization bearer token and Notion-Version header in the request.

How do I query a Notion database with filters?▼

POST to /v1/data_sources/{data_source_id}/query with a JSON body containing filter and sorts objects. In API version 2025-09-03, databases are called data sources, so use the data_source_id rather than the database_id for queries.

Why does the Notion API return no results for my pages?▼

The integration must be explicitly connected to each page or database in Notion. Open the page, click the "..." menu, choose "Connect to", and select your integration name before the API can access it.

What is the difference between database_id and data_source_id in Notion?▼

In API version 2025-09-03 each database has both IDs. Use database_id when creating pages as the parent, and data_source_id when querying via the /v1/data_sources/{id}/query endpoint.

What are the rate limits of the Notion API?▼

The Notion API allows roughly 3 requests per second on average. For bulk operations, space out requests and pipe curl output through jq to inspect responses for rate limit errors.

Related Skills

Explore More Product & Management Skills→
linuxhsjlinuxhsj
5.1k

notion

Manage Notion pages, databases, and blocks via the Notion API.

Community
Intermediate
cdeistopenedcdeistopened

schedule-approved

Schedule approved Notion content to social media via GetLate API.

Community
Advanced
riftzen-bitriftzen-bit

data-scraper-agent

Collect and monitor public web and API data on a schedule.

Community
Advanced
kaminocorpkaminocorp
1

notion

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

Official
Intermediate