skills.rest
HKU-MMLab
HKU-MMLabOFFICIAL
Explore all skills by this author →
GitHub

notion-token-api

Read Notion pages, blocks, and child pages through the Notion API using an integration token.

39|1|Updated Jul 2, 2026
Search Tags:#api#python#notion#rest api#page retrieval#workspace search#integration token
One-click install
npx skills add https://github.com/HKU-MMLab/UniClawBench --skill notion-token-api-hku-mmlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-token-api
Source: https://github.com/HKU-MMLab/UniClawBench/tree/main/injection/101_skill_usage/task_101_21_notion_consolidate/skills/notion-token-api
Command: npx skills add https://github.com/HKU-MMLab/UniClawBench --skill notion-token-api-hku-mmlab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Accessing Notion workspace content programmatically requires correct API authentication and request formatting, which is error-prone when done ad hoc. This Skill provides ready-to-use instructions for reading Notion pages, blocks, and child pages with an existing integration token. ## Core Features & Use Cases - Workspace Search: Query the Notion API search endpoint to list accessible pages and databases with a single authenticated request. - Token-Based Access: Uses the provided NOTION_API_TOKEN environment variable without creating new integrations or storing credentials on disk. - Snapshot Handling: Reads exported Notion snapshots while preserving supplied page IDs in outputs. - Use Case: When consolidating information scattered across a Notion workspace, use this Skill to search and read all accessible pages, then merge their content into a single structured summary. ## Quick Start Use the Notion API with my integration token to search the workspace and read the contents of all accessible pages.

Frequently Asked Questions about notion-token-api

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

FAQPage Schema
How do I read Notion pages with the Notion API?▼

Authenticate with an integration token passed as a Bearer token, set the Notion-Version header to 2022-06-28, and POST to the /v1/search endpoint. The response lists accessible pages and databases, which you can then query individually for blocks and child pages.

How to search a Notion workspace using an integration token?▼

Send a POST request to https://api.notion.com/v1/search with your token in the Authorization header and a JSON body specifying page_size. The API returns all pages and databases shared with your integration, up to the requested limit.

Does the Notion API require creating a new integration for each task?▼

No, this Skill uses the existing NOTION_API_TOKEN environment variable and explicitly avoids creating new integrations or writing tokens to disk. You only need a token already shared with the target pages.

Why does the Notion API return empty search results?▼

Empty results usually mean the integration has not been granted access to any pages. In Notion, you must explicitly share pages or databases with your integration before they appear in API search responses.

Can I use an exported Notion snapshot instead of the live API?▼

Yes, when a task provides an exported Notion snapshot, read that file directly instead of calling the API. Preserve the supplied page IDs in your outputs so downstream references remain consistent.

Related Skills

Explore More Software Engineering Skills→
CyandexCyandex

notion

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

Community
Intermediate
hoanghd218hoanghd218
3

github-trend-finder

Scrape GitHub Trending pages and export repository summaries as JSON and Markdown.

Community
Intermediate
anthropicsanthropics
37

notion-api

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

Official
Advanced
OpenMinisOpenMinis
361

notion-hub

Perform Notion read/write operations via Python CLI using notion-client SDK.

Official
Intermediate