← All skills
notion-api
90 / 100 · Low risk
Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.
By mkurman/zorai (GitHub) · coding · 327 stars · scanned at commit 8ea1fc3
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.
Works with any agent that supports SKILL.md skills.
What this skill can do
Sends data to these websites: api.notion.com
The author does not mention this.
Found in 22 places.
Show 17 more
- skills/productivity/agent-skills/notion-api/SKILL.md, line 101
curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 119
curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 131
curl -s "https://api.notion.com/v1/pages/{page_id}/properties/{property_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 141
curl -s "https://api.notion.com/v1/blocks/{block_id}/children?page_size=100" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 151
curl -s -X PATCH "https://api.notion.com/v1/blocks/{block_id}/children" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 185
curl -s "https://api.notion.com/v1/blocks/{block_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 193
curl -s -X PATCH "https://api.notion.com/v1/blocks/{block_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 209
curl -s -X DELETE "https://api.notion.com/v1/blocks/{block_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 221
curl -s "https://api.notion.com/v1/databases/{database_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 231
curl -s -X POST "https://api.notion.com/v1/databases/{database_id}/query" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 252
curl -s -X POST "https://api.notion.com/v1/databases" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 281
curl -s -X PATCH "https://api.notion.com/v1/databases/{database_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 298
curl -s -X POST "https://api.notion.com/v1/data_sources" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 317
curl -s "https://api.notion.com/v1/users?page_size=100" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 325
curl -s "https://api.notion.com/v1/users/{user_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 333
curl -s "https://api.notion.com/v1/users/me" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 343
curl -s "https://api.notion.com/v1/comments?block_id={block_id}&page_size=100" \
and 2 more places
Runs commands on your computer
The author does not mention this. Expected for a coding skill.
Found in 22 places.
Show 17 more
- skills/productivity/agent-skills/notion-api/SKILL.md, line 101
curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 119
curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 131
curl -s "https://api.notion.com/v1/pages/{page_id}/properties/{property_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 141
curl -s "https://api.notion.com/v1/blocks/{block_id}/children?page_size=100" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 151
curl -s -X PATCH "https://api.notion.com/v1/blocks/{block_id}/children" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 185
curl -s "https://api.notion.com/v1/blocks/{block_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 193
curl -s -X PATCH "https://api.notion.com/v1/blocks/{block_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 209
curl -s -X DELETE "https://api.notion.com/v1/blocks/{block_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 221
curl -s "https://api.notion.com/v1/databases/{database_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 231
curl -s -X POST "https://api.notion.com/v1/databases/{database_id}/query" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 252
curl -s -X POST "https://api.notion.com/v1/databases" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 281
curl -s -X PATCH "https://api.notion.com/v1/databases/{database_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 298
curl -s -X POST "https://api.notion.com/v1/data_sources" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 317
curl -s "https://api.notion.com/v1/users?page_size=100" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 325
curl -s "https://api.notion.com/v1/users/{user_id}" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 333
curl -s "https://api.notion.com/v1/users/me" \ - skills/productivity/agent-skills/notion-api/SKILL.md, line 343
curl -s "https://api.notion.com/v1/comments?block_id={block_id}&page_size=100" \
and 2 more places
Install
Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.
if [ -e ~/.agents/skills/'notion-api' ] || [ -L ~/.agents/skills/'notion-api' ]; then echo 'A skill folder named notion-api already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/mkurman/zorai' "$d" && git -C "$d" checkout --quiet '8ea1fc3ae126b6e103b8508bacd8f5aa60b6f4ad' -- 'skills/productivity/agent-skills/notion-api' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/productivity/agent-skills/notion-api' ~/.agents/skills/'notion-api' && rm -rf "$d"; fi
Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'notion-api' ~/.claude/skills/'notion-api' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.
Badge for your README
The badge for mkurman/zorai shows the score of its lowest-scoring skill.
[](https://zalavijaysinh.github.io/skilltrust/repos/mkurman/zorai/)
Score history
| Date | Version | Score |
|---|
| 2026-11-13 | 8ea1fc3 | 90 |