notion SKILL.md skillA
notion from openhands/extensions is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add openhands/extensions/notion@git:20260701.599cc4dPins git:20260701.599cc4d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- openhands/extensions
- Path
skills/notion/SKILL.md- Versions recorded
- 3
- Latest version
- git:20260701.599cc4d, committed Jul 1, 2026
- First version recorded
- Jan 13, 2026
- Size
- 3,786 bytes
- Repository stars
- 179
- License
- MIT
Create, search, and update Notion pages/databases using the Notion API. Use for documenting work, generating runbooks, and automating knowledge base updates.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Notion Windows PowerShell equivalents for the repeated Notion REST `curl`, environment-variable, and JSON-body snippets are in `references/windows.md`. <IMPORTANT> If authenticated Notion MCP tools are available in the environment, use them first. MCP tools do not require passing `NOTION_INTEGRATION_KEY` as a tool argument; authentication is handled by the configured MCP integration. Use the direct Notion REST API examples below only when MCP is unavailable or when you explicitly need raw API/curl access. For that direct-API path, first check whether the required environment variable is set: ```bash [ -n "$NOTION_INTEGRATION_KEY" ] && echo "NOTION_INTEGRATION_KEY is set" || echo "NOTION_INTEGRATION_KEY is NOT set" ``` If it’s missing and you need the direct API path, ask the user to provide it (or connect a Notion integration) before proceeding: - **NOTION_INTEGRATION_KEY**: Notion integration secret (starts with `ntn_...`) Whether you use MCP or the direct API, also confirm the configured integration has been **shared** with the target page/database in Notion. </IMPORTANT> ## Base headers for direct API calls ```bash …
Read the whole file at its exact version.
How to install
mdr add openhands/extensions/notion@sha256:2ae4b3833a317815The line at the top of this page pins the label git:20260701.599cc4d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_y4it5lwkqxqahwfp)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Jan 13, 2026 and Jul 1, 2026, about one every 85 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260701.599cc4d latest | 2026-07-01 | 599cc4d | 3,786 B | A | view · diff |
| git:20260403.95c9abf | 2026-04-03 | 95c9abf | 3,640 B | A | view · diff |
| git:20260113.ddc8302 | 2026-01-13 | ddc8302 | 3,198 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3786 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
openhands/extensions · 179 stars · license MIT · pushed 2026-11-08 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_y4it5lwkqxqahwfp GET https://markdownregistry.com/api/v1/resolve?ref=openhands/extensions/notion GET https://markdownregistry.com/api/v1/blob/2ae4b3833a31781501c64e50ecfdda7c1abff34cc33687b039737a2731ab7ac7
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from openhands/extensions
Every file in openhands/extensions