skills.rest
srgaba
srgabaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

notion

Create, query, and update Notion pages, data sources, and blocks via the Notion API.

Updated Mar 30, 2026
Search Tags:#automation#database#api#workspace#notion#curl#pages
One-click install
npx skills add https://github.com/srgaba/open-claw --skill notion-srgaba
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/notion
Command: npx skills add https://github.com/srgaba/open-claw --skill notion-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Notion workspaces programmatically requires navigating API authentication, version-specific endpoints, and complex property schemas, which slows down automation of documentation and database workflows. ## Core Features & Use Cases - Page and Block Management: Create, read, and update pages and append content blocks such as paragraphs to any page. - Data Source Operations: Query databases with filters and sorts, and create new data sources with custom property schemas. - Search and Discovery: Search across pages and data sources by title to locate content in the workspace. - Use Case: Automatically log completed tasks from a CI pipeline into a Notion database by creating pages with Status and Date properties, then query the data source to generate a weekly summary. ## Quick Start Use the notion skill to create a new page in my project tracker database with the title "Sprint Review" and status set to "Todo".

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 set to the database_id and a properties object defining fields like title and select values. Include the Authorization bearer token and Notion-Version header in the request.

How do I query a Notion database with filters?▼

In API version 2025-09-03, send a POST request to /v1/data_sources/{data_source_id}/query with a filter object such as a select property equals condition and optional sorts. Note that querying uses the data_source_id, not the database_id.

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

In Notion API version 2025-09-03, each database has both a database_id and a data_source_id. Use database_id when creating pages as the parent, and data_source_id when querying or retrieving the data source.

Why does my Notion API request return a 429 rate_limited error?▼

The Notion API enforces a rate limit of roughly 3 requests per second on average. When you receive a 429 rate_limited response, wait for the duration specified in the Retry-After header before retrying the request.

What are the limits when adding blocks to a Notion page?▼

Appending block children supports up to 100 children per request and up to two levels of nesting in a single append call. Overall payloads are limited to 1000 block elements and 500KB in size.

Related Skills

Explore More Product & Management Skills→
swcstudiospaceswcstudiospace

notion

Manage Notion pages, databases, and Workers via the ntn CLI or HTTP API.

Official
Advanced
nomad3nomad3

notion

Manage Notion pages, blocks, and data sources via the Notion API.

Community
Basic
llmh333llmh333

data-scraper-agent

Automate scheduled collection, AI enrichment, and deduplicated storage of public data.

Community
Advanced
HaraldeRoesslerHaraldeRoessler

notion

Query, create, update, and append content in Notion workspaces via the REST API.

Community
Intermediate