notion

Read and write Notion pages and databases via the Notion API.

2|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/autonomy-cloud/kairos-interface --skill notion-autonomy-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/autonomy-cloud/kairos-interface/tree/main/skills/notion
Command: npx skills add https://github.com/autonomy-cloud/kairos-interface --skill notion-autonomy-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the need to manually browse, copy, and update Notion pages by letting an assistant read and write page and database content through the Notion API.

Core Features & Use Cases

  • Page and block retrieval: Fetch page metadata and traverse block children to reconstruct readable content for multiple block types.
  • Database search and querying: Search across pages and databases and query database rows with filters, sorts, and pagination.
  • Create, update, and archive content: Create new pages (including under databases), update page properties, append blocks, update block content, and archive blocks/pages.

Quick Start

Use the notion skill to search for your latest “In Progress” tasks in a Notion database and summarize their due dates and owners.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I query a Notion database to find tasks with specific filters?

You can query a Notion database by sending authenticated API requests with specific filters and sorts to retrieve matching rows. The Skill handles pagination and rich-text extraction to return structured row data.

Can I update Notion page properties and append new blocks via the API?

Yes, you can update page properties and append new blocks via authenticated API requests. The Skill supports creating pages under databases, updating block content, and archiving blocks or pages.

What do I need to set up to read and write Notion pages programmatically?

Reading and writing Notion pages requires credential discovery for the Notion service to authenticate requests. You must send requests to the Notion API endpoint with the correct Notion-Version header.

How does the Notion API handle retrieving page content and block trees?

The API retrieves page metadata and traverses block children to reconstruct readable content across multiple block types. The Skill handles pagination and rich-text extraction to build complete block trees.

Is it possible to archive or delete Notion pages and blocks using an API integration?

Yes, the API integration supports correct archive and delete semantics for Notion blocks and pages. You can programmatically archive unwanted blocks or pages to maintain clean productivity workflows.

What's the best way to search across multiple Notion pages and databases?

The best way to search across Notion pages and databases is using the API search endpoint with authenticated requests. The Skill manages pagination to return comprehensive results across your workspace.