notion

Create, retrieve, update, and manage Notion pages, blocks, and data sources via API.

2|2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/pynbj1001/agent-workspace --skill notion-pynbj1001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/pynbj1001/agent-workspace/tree/main/skills/notion
Command: npx skills add https://github.com/pynbj1001/agent-workspace --skill notion-pynbj1001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a straightforward, API-driven way to programmatically create, read, update, and compose content inside Notion so you can integrate Notion into automation, synchronization, and content generation workflows without manual editing.

Core Features & Use Cases

  • Page Management: Create, retrieve, and update Notion pages and their properties for automated content generation and record-keeping.
  • Data Source (Database) Operations: Create data sources, query items, and insert database rows for syncing external systems or batch imports.
  • Block Composition: Read and append blocks to pages to build structured documents or programmatically update page content.
  • Use Case: Automatically create meeting notes as pages in a Notion data source, set status fields, and append action items as blocks after each meeting.

Quick Start

Use the notion skill to create a new page in a specified data source with a title and properties such as Status and Date.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I automate creating Notion pages and database items via API?

Automating Notion pages and database items via API requires authenticated HTTP requests with a Notion API key and the Notion-Version header. You send JSON payloads to endpoints for pages, blocks, and data sources to create content and manage records programmatically.

Can I append blocks to an existing Notion page programmatically?

Yes, appending blocks to an existing Notion page programmatically is supported. The API allows you to read and append blocks to build structured documents, enabling automated content generation and updates without manual editing.

What do I need to query a Notion data source and insert rows?

Querying a Notion data source and inserting rows requires an authenticated Notion API key and the Notion-Version header. You use API endpoints to query items and send JSON payloads to insert database rows for syncing external systems or batch imports.

What's the best way to sync external data into a Notion database?

The best way to sync external data into a Notion database is using API-driven automation to create data sources and insert database rows. This method programmatically updates properties and composes page blocks for batch imports or synchronization workflows.

Does managing Notion page properties require specific API headers?

Yes, managing Notion page properties requires the Notion-Version header along with an authenticated Notion API key. These are sent via HTTP requests to update page properties and compose blocks using JSON payloads.