notion-api
Comprehensive REST API reference for reading, creating, updating
by intellectronicaFree
Description
Notion API is an agent skill that reads and writes Notion workspaces through the Notion REST API. It is a reference for the core endpoints, covering pages, blocks, databases, data sources, users and comments, with curl examples and the required headers for each request. The agent uses curl and jq for direct calls, or writes an ad-hoc script when the task needs one. The skill sets out how the API key is handled. It first checks for a NOTION_API_TOKEN environment variable, then uses a key the user supplies in the conversation, and if neither exists it asks the user for the key. The skill is strict that the token must never be displayed, logged or sent anywhere other than the Authorization header. It also documents the API's rate limit, which is an average of three requests per second, and the request headers every call needs. The skill is written to be used whenever a user asks to interact with Notion, such as creating a page, updating a database, reading blocks or adding a comment. It is listed on skills.sh under the intellectronica agent-skills repository. Its security audits show Gen Agent Trust Hub: Pass, Socket: Pass and Snyk: Warn.…
Highlights
- Covers pages, blocks, databases, data sources, users and comments
- curl and jq examples with required headers
- API token read from environment or user input
- Documents the three-requests-per-second rate limit
Ratings & Reviews
No ratings yet
Be the first to rate notion-api.
People also visit
browser-fingerprint-audit
Audit a browser fingerprint for internal contradictions with the liarjs CLI
coding-agent
Delegate coding work to Codex, Claude Code, or OpenCode as background workers
gh-issues
Fetch GitHub issues, select candidates, spawn background fix agents, open PRs
notion-api FAQ
What does the skill do?
It lets an AI agent read and change a Notion workspace through the Notion REST API, using curl and jq or short scripts.
Which parts of Notion does it cover?
Pages, blocks, databases, data sources, users and comments, with examples for each core endpoint.
How is my API key handled?
The skill checks the NOTION_API_TOKEN environment variable first, then a key you give in the conversation, and asks for one if neither is present. The token is only sent in the Authorization header.
Is there a rate limit?
The skill documents an average of three requests per second.
How do I install it?
Run npx skills add https://github.com/intellectronica/agent-skills --skill notion-api.
What security audits has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Warn. A Warn or Fail is worth reading before you install.
What are the best notion-api alternatives?
Popular alternatives to notion-api include build-zoom-rest-api-app, lfg and browser-fingerprint-audit. See all notion-api alternatives