notion

Search, read, and write Notion pages and databases via REST API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually searching, reading, and updating Notion workspaces by providing a direct REST API workflow for common page and database operations.

Core Features & Use Cases

  • Workspace search and page discovery: Find pages and child pages by query to quickly locate relevant content.
  • Read and append page content: Retrieve page metadata or full block content, then append new paragraphs to keep notes up to date.
  • Database querying and creation: Query database entries with filters/sorts and create new pages in a database (including template-driven use via the Notion API).

Use case: When tracking a team’s Q1 roadmap, search for the right project page, append meeting notes as a new paragraph, then query the tasks database for items with a given status and create a new entry when a new task is confirmed.

Quick Start

Use notion to search your workspace for a page named Q1 budget and then append a new paragraph to the matching page.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I append content to a Notion page using the REST API?

To append content to a Notion page, use the REST API to retrieve existing page content blocks and append new paragraphs via curl commands with jq. This requires a user OAuth bearer token in NOTION_TOKEN and the Notion-Version header to execute the write operations deterministically.

Can I query a Notion database with filters and sorts to track tasks?

Yes, you can query a Notion database with filters and sorts to track tasks. The Skill queries database entries to locate items with a given status, and creates new pages in the database when a new task is confirmed via authenticated REST API calls.

What is the best way to search a Notion workspace for specific pages?

The best way to search a Notion workspace for specific pages is by performing a workspace discovery query. You find pages and child pages by query to quickly locate relevant content, using the Notion REST API with a valid OAuth bearer token and Notion-Version header.

Do I need an OAuth bearer token to read and write Notion workspace data?

Yes, you need a user OAuth bearer token in NOTION_TOKEN to read and write Notion workspace data. The workflow uses curl with jq to execute Notion REST API calls deterministically, requiring this token and the Notion-Version header for authentication.

Does this approach work for logging meeting notes into a Notion knowledge base?

Yes, this approach works for logging meeting notes into a Notion knowledge base. You can locate the right project page, retrieve page metadata or full block content, and append meeting notes as a new paragraph to keep your knowledge base updates current.

What are the limitations of using curl and jq for Notion database operations?

Using curl and jq for Notion database operations limits you to deterministic REST API execution, requiring manual handling of JSON responses. You rely on the Notion REST API's native capabilities for page discovery, block retrieval, and database entry creation without a visual interface.