skills.rest
anthropics
anthropicsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

notion-api

Search, read, and update Notion workspaces via the Notion API.

37|13|Updated Jun 23, 2026
Search Tags:#api#notion#pagination#content editing#workspace search#database rows#block traversal
One-click install
npx skills add https://github.com/anthropics/claude-tag-plugins --skill notion-api-anthropics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-api
Source: https://github.com/anthropics/claude-tag-plugins/tree/main/notion/skills/notion-api
Command: npx skills add https://github.com/anthropics/claude-tag-plugins --skill notion-api-anthropics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill removes the friction of manually hunting through Notion workspaces and editing content by letting you search, read, and write pages, databases, and blocks through a reliable API workflow.

Core Features & Use Cases

  • Workspace Search: Find pages and databases by title across everything the integration can access.
  • Reading Content: Retrieve page metadata, traverse block trees, and pull full page bodies in document order.
  • Writing and Updating: Create database rows, create sub-pages, update properties, and append or edit blocks.
  • Operational Guidance: Use the bundled scripts for repeatable search and page-reading tasks, and consult the reference docs for endpoint details, filters, and block types.

Quick Start

Ask this skill to find the relevant Notion page or database, read its contents, and update or append the blocks you need.

Frequently Asked Questions about notion-api

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

FAQPage Schema
How do I search Notion pages and databases by title through the API?▼

You can search Notion pages and databases by title across everything the integration can access using the workspace search feature. It requires shared access to the content and the Notion-Version 2025-09-03 header.

How do I read and traverse Notion block trees to get full page content?▼

Reading Notion page bodies involves retrieving page metadata and traversing block trees in document order. The Skill handles pagination automatically to pull full content sequentially using the Notion API.

Can I create database rows and append blocks in Notion using curl and jq?▼

Yes, you can create database rows, create sub-pages, update properties, and append or edit blocks in Notion. The Skill uses bundled scripts with curl and jq for repeatable content writing and updating tasks.

What prerequisites do I need to manage Notion content through an API workflow?▼

You need curl and jq installed, shared access granted to the Notion integration, relevant page or data source IDs, and the Notion-Version 2025-09-03 header configured for API requests.

Does this approach handle Notion API pagination for large workspace reads?▼

Notion API pagination is handled natively when reading page bodies and traversing block trees. This ensures complete content retrieval across large workspaces without manual cursor management.

Why are my Notion API search results missing pages I know exist?▼

Notion API workspace search only returns pages and databases the integration has been explicitly granted shared access to. Ensure the relevant pages are connected to your integration to make them discoverable.

Related Skills

Explore More Software Engineering Skills→
zerwizzerwiz

notion

Manage Notion workspace content via authenticated curl requests.

Community
Intermediate
aresbitaresbit
46

notion

Create, read, and update Notion pages, databases, and blocks via the Notion API.

Community
Intermediate
pynbj1001pynbj1001
2

notion

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

Community
Intermediate
gquthiergquthier
14

notion

Automate Notion page, database, and block management via curl.

Community
Intermediate