notion-api
>
What it does
- Base URL: https://api.notion.com
- API Version: 2025-09-03 (required header)
- Data Format: JSON for all request/response bodies
- IDs: UUIDv4 format (dashes optional in requests)
- Timestamps: ISO 8601 format (2020-08-12T02:12:33.231Z)
- Property Names: snakecase
- Empty Values: Use null instead of empty strings
Requirements & configuration
- API Key Handling
- 2. User-Provided Key: If the user provides an API key in context, use that instead
- 3. No Key Available: If neither is available, use AskUserQuestion (or equivalent) to request the API key from the user
- All requests require these headers:
- Test the API key by retrieving the bot user:
Configuration: NOTION_API_TOKEN
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
notion-api FAQ
What does the notion-api skill do?
> This skill provides comprehensive instructions for interacting with the Notion API via REST calls. This skill should be used whenever the user asks to interact with Notion, including reading, creating, updating, or deleting pages, databases, blocks, comments, or any other Notion content. The skill covers authentication, all available endpoints, pagination, error handling, and best practices. Base URL: https://api.notion.com API Version: 2025-09-03 (required header)
What does notion-api require?
API Key Handling 2. User-Provided Key: If the user provides an API key in context, use that instead 3. No Key Available: If neither is available, use AskUserQuestion (or equivalent) to request the API key from the user All requests require these headers: Test the API key by retrieving the bot user: Configuration keys: NOTION_API_TOKEN.
How do I install notion-api?
Run: npx -y skills add https://github.com/intellectronica/agent-skills --skill notion-api --agent claude-code — the source lives at github.com/intellectronica/agent-skills.
Maintain notion-api?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/intellectronica-agent-skills-notion-api?ref=badge) npx agentictools info skills/intellectronica-agent-skills-notion-api The second line is the CLI lookup for this page — handy in READMEs and docs.
Related skills
baoyu-url-to-markdown Fetch any URL and convert to markdown using baoyu-fetch CLI (Chrome CDP with site-specific adapters). Built-in adapters for X/Twi…
gws-workflow-email-to-task Convert Gmail messages into Google Tasks entries with subject-to-title mapping.
recipe-create-task-list Initialize a Google Tasks list and populate it with multiple tasks via command sequence.
video-ad-specs Agent skill from 101-skills/skills.
to-spec Agent skill from mattpocock/skills.
higgsfield-product-photoshoot Professional product photography generation across 10 specialized modes via GPT Image 2.