notion-api: a Claude Code skill by Eleanor Berger
For people who want Claude to read and change Notion pages and databases through the REST API. Skip it if you would rather not hand Claude a Notion API token.
- Score
- 59of 100
- Rank
- #224of 239
- Installs
- 103Kon skills.sh
- Security
- Mixed 5 scanners
- Updated
- 2026
- Context
- ~101tokens always
Install
npx skills add https://github.com/intellectronica/agent-skills --skill notion-api Run it in your terminal. View the source
Using the Claude app rather than Claude Code? You can add a skill there too. How to add it in the app
What does notion-api do?
notion-api is a Claude skill that teaches Claude to work with Notion through direct REST calls using curl and jq. It looks for a NOTION_API_TOKEN in the environment, asks you for one if it is missing, and keeps it out of any output. Claude checks the token with /v1/users/me, then searches, reads pages and block children, creates pages, appends blocks, queries and creates databases and data sources, and posts comments, all on API version 2025-09-03. It asks before updates, deletes or batch creation. It also covers pagination, a rate limit of about three requests per second with backoff on 429 errors, and payload size limits.
When should you use notion-api?
Use it when
- Adding pages or rows to a Notion database
- Pulling page content out of Notion
- Updating many database properties at once
Skip it when
- You cannot create a Notion integration token
- You do not want Claude able to archive Notion pages
What it needs and what it can touch
You need
- A Notion integration API token
- curl and jq
What it can do
- Runs curl commands against the Notion API
- Reads, creates, updates and archives Notion content
- Sends data to an outside service (Notion)
From reading its instructions, not from running it.
Why it scores 59
Strongest on quality (100 of 100), weakest on upkeep (40).
Is notion-api safe to install?
At least one scanner raised a medium warning. Read the results below. Scanners often miss what other scanners catch, and a skill can change after a scan. Read its source before you install it.
| Scanner | Result | Date |
|---|---|---|
| Gen Agent Trust Hub | Passed | Sep 14, 2026 |
| Socket | Passed | Sep 14, 2026 |
| Snyk | Medium risk | Sep 14, 2026 |
| Runlayer | Medium risk | Feb 21, 2026 |
| ZeroLeaks | Passed | Apr 16, 2026 |
Details
- Installs
- 102,846
- Repository stars
- 301
- Last repository change
- Tokens always loaded
- about 101
- Tokens when used
- about 3,556
- License
- Custom
- Data confidence
- High
Did it do the job for you?
Alternatives to notion-api
All skills for this job-
Get gws-gmailgws-gmail
For gws CLI users who want Claude to read, triage, send and reply to Gmail from the terminal.
notion-api