notion

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill notion-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/notion
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill notion-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Notion workspaces programmatically requires navigating the Notion API's authentication, versioning, and property formats, which is error-prone when done manually. This Skill provides ready-to-use curl commands and property schemas for automating page, database, and block operations. ## Core Features & Use Cases - Page and Block Management: Create, read, and update pages, and append content blocks such as paragraphs to existing pages. - Data Source Operations: Query databases with filters and sorts, and create new data sources with typed properties like select, date, and relation. - Search and Discovery: Search across pages and data sources by title to locate content programmatically. - Use Case: Imagine you want to log daily standup notes into a Notion database automatically. Use this Skill to query the data source, create a new page with the date and status properties, and append summary blocks. ## Quick Start Use the notion skill to create a new page in my tasks database with the title "Weekly Report" 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 your database_id and properties formatted by type, such as title and select. Include the Authorization bearer token and Notion-Version header in the request.

How to query a Notion database with filters?

POST to the /v1/data_sources/{data_source_id}/query endpoint with a filter object, for example matching a select property value, plus optional sorts. In API version 2025-09-03, databases are queried as data sources using their data_source_id.

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

In Notion-Version 2025-09-03, each database has both IDs. Use database_id when creating pages as the parent, and data_source_id when querying or retrieving the data source via the /v1/data_sources/ endpoints.

Why does my Notion API request fail with authentication errors?

Requests fail when the API key is missing, malformed, or the integration lacks access. Verify the key starts with ntn_ or secret_, include the Notion-Version header, and share the target pages or databases with your integration.

What are the rate limits of the Notion API?

The Notion API allows roughly 3 requests per second on average. Batch operations where possible and add delays between calls in loops to avoid throttling errors.