Notion API
Comprehensive guide to the Notion REST API — pages, databases, blocks, comments, auth, pagination, error handling
- What
- Comprehensive guide to the Notion REST API — pages, databases, blocks, comments, auth, pagination, error handling
- Cost
- Free
- Needs
- a Notion account with an API token (NOTION_API_TOKEN in the environment or provided at use time — never paste it into files); curl and jq
- Install
- Copy the installer prompt below into your Muse — your agent does the rest.
Curated by Skill Harbor — a comprehensive skill for interacting with Notion workspaces through the REST API via `curl`/`jq`: authentication (env var or user-provided key, never echoed), all endpoints for pages, databases, blocks, and comments, pagination, rate limits, and best practices. License is CC0-1.0 (public domain dedication). By @intellectronica, listed here with credit to its creator. Honest caveats: requires a Notion account and an API token — free tier works; API calls are real (create/update/delete actually change your workspace), so the skill's key-handling rules matter. Skill Harbor never reviews the code, review it yourself before use.
Version:
Quick answer
Notion API is a free listing for a comprehensive guide to the Notion REST API via curl and jq. It covers authentication, all endpoints for pages, databases, blocks and comments, pagination, rate limits and best practices. It requires a Notion account and an API token, with the free tier working, but API calls are real and actually change your workspace.
Install
Copy the install package below, then paste it into Muse🧪 Install ran in our test sandbox · Nov 11, 2026📌 Pinned version: commit 9b0e00aStep 0 — before installing anything: read this install prompt, summarize in a few lines what this build does and what installing it involves, then ask me to confirm before you proceed. Prerequisites: a Notion account with an API token (NOTION_API_TOKEN in the environment or provided at use time — never paste it into files); curl and jq Install "Notion API" for me. Comprehensive guide to the Notion REST API — pages, databases, blocks, comments, auth, pagination, error handling Repository: https://github.com/intellectronica/agent-skills Pinned version: install the code at commit 9b0e00ad1b941165e2506545bbfddafa34cf2cb8 exactly (Skill Harbor tested this version). Do not substitute a newer version. If this commit is unreachable, stop and tell me. 1. Fetch the SKILL.md file for the intellectronica-notion-api skill from the repository into a temporary folder 2. Safety check: review the SKILL.md and scripts for anything suspicious (unexpected network calls, shell commands, credential harvesting). This repo should contain zero secrets in code, credentials only via the secure vault, allowed hosts declared in the SKILL.md. Verify that holds here; STOP on any red flag and tell me. 3. Install it as a skill: copy SKILL.md and its helper files into the agent's skills directory, in a folder named "intellectronica-notion-api". 4. Verify with no network calls: frontmatter valid, files in place. 5. Report what was installed, where, and what I still need to do myself (e.g. any accounts, API keys, or CLI tools mentioned in the prerequisites above). GitHub is optional: if I have a GitHub account or the gh CLI, you may use it; otherwise public access is fine. Never require it unless it's in the prerequisites above. Rules: don't touch anything outside the temp folder and the install target. Never ask me to paste secrets in chat — credentials go through the secure vault or environment variables. If anything looks off, stop and ask me.
Saved to your recent installs. Find it anytime on /connect.
🔒 Security, provenance and what this touches
- It works with an API key or a token that you provide.
What the scan found — excerpts from the install prompt
- uses API keys or tokens — Prerequisites: a Notion account with an API token (NOTION_API_TOKEN in the environment or provided at use time
The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?
Verification certificate
Dated facts about what was checked for this listing, and how. This is not a safety certification.
- Pinned version
- 9b0e00a · 2026-10-13
- Sandbox install test
- Install ran in our test sandbox · Nov 11, 2026
- Creator identity
- Not verified
- Install prompt analysis
- 2026-10-13 : uses API keys or tokens
Skill Harbor never reviews the code of a listed skill. These are dated facts about the install prompt and our install test, not a safety certification. Review a skill yourself before you install it. How we verify
Questions
How do I install a skill?
Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the skill up for you — no manual configuration.
Where does my money go?
Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.
What does the ✓ next to a creator’s name mean?
It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a skill before installing it.