Notion Api
- 279 repo stars
- Updated April 25, 2026
- intellectronica/agent-skills
notion-api is an agent skill that guides authenticated REST integration with Notion for pages, databases, blocks, and comments.
About
notion-api is a procedural agent skill that teaches your assistant how to call the Notion REST API correctly when you want specs, roadmaps, or customer notes living in Notion to stay in sync with code. developers use it to list and query databases, append blocks to pages, update properties, manage comments, and handle deletes without guessing endpoint shapes or cursor pagination. The skill emphasizes authentication, available endpoints, pagination, and error handling so agents fail loudly instead of silently truncating results. It fits agents that can issue HTTP requests with your integration token rather than replacing the official Notion MCP. Invoke it during build when you automate onboarding docs, sync issue status from a repo, or prototype a lightweight CMS backed by Notion. Skip it if you only need one-off copy-paste from Notion without ongoing API automation.
- Full Notion REST surface: pages, databases, blocks, comments, and related content operations
- Authentication setup, pagination patterns, and error-handling best practices
- Use whenever the user asks to interact with Notion—not only for single CRUD actions
- Structured guidance for read, create, update, and delete flows via API calls
Notion Api by the numbers
- Data as of Jul 20, 2026 (Skillselion catalog sync)
/plugin marketplace add intellectronica/agent-skills/plugin install notion-api@intellectronica-skillsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| repo stars | ★ 279 |
|---|---|
| Last updated | April 25, 2026 |
| Repository | intellectronica/agent-skills ↗ |
What it does
Let your coding agent read, create, update, and delete Notion pages, databases, blocks, and comments via authenticated REST calls.
Who is it for?
Best when you're automating Notion as a wiki, CRM-lite database, or content backend from Claude Code, Cursor, or Codex.
Skip if: Skip if you only browse Notion in the browser with no API token or no need for scripted CRUD.
When should I use this skill?
Whenever the user asks to interact with Notion, including reading, creating, updating, or deleting pages, databases, blocks, comments, or other Notion content.
What you get
After the skill runs, the agent can perform documented Notion API operations with consistent auth, pagination, and error handling.
- Executed or scripted Notion API requests with correct auth and pagination
- Updated Notion pages, database rows, blocks, or comments per user intent
Files
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.
notion-api
Source: ./plugins/notion-api
{ "name": "notion-api", "source": "./plugins/notion-api", "version": "0.1.1769613281", "category": "integrations", "description": "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." }
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.471k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.382k15.8kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.381k15.8k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k37Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.230k15.8k
SupabaseGet accurate, up-to-date Supabase implementation guidance across database, auth, realtime, storage, edge functions and vector search without relying on outd182k2.4kHow it compares
Procedural REST integration skill—not the official Notion MCP server or a no-code Zapier substitute.
FAQ
Who is notion-api for?
Developers and agent users who need reliable Notion REST calls for pages, databases, blocks, and comments from their coding environment.
When should I use notion-api?
During Build integrations whenever you ask the agent to read, create, update, or delete Notion content via the API.
Is notion-api safe to install?
It implies network access and Notion secrets; review the Security Audits panel on this Prism page and scope integration tokens minimally.