notion is agent-read markdown (skill) from trpc-group/trpc-agent-go: Notion API for creating and managing pages, databases, and blocks..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# notion
Use the Notion API to create/read/update pages, data sources (databases), and blocks.
## Setup
1. Create an integration at https://notion.so/my-integrations
2. Copy the API key (starts with `ntn_` or `secret_`)
3. Store it:
```bash
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
```
4. Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)
## API Basics
All requests need:
```bash
NOTION_KEY=$(cat ~/.config/notion/api_key)
curl -X GET "https://api.notion.com/v1/..." \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json"
```
> **Note:** The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called "data sources" in the API.
## Common Operations
**Search for pages and data sources:**
```bash
curl -X POST "https://api.notion.com/v1/search" \
-H "Authorization: Bearer $NOTION_KEY" \
-H "Notion-Version: 2025-09-03" \
-H "Content-Type: application/json" \
-d '{"query": "page title"}'
```
**Get page:**
```bash
curl "https://api.notion.com/v1/pages/{page_id}" \
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_hhclcjyts43t522w
GET https://markdownregistry.com/api/v1/resolve?ref=trpc-group/trpc-agent-go/notion
GET https://markdownregistry.com/api/v1/blob/b1ec55de3a74e1c0322c0731083f5c0b82356dc35e97cd7866ad17553ab43cff
Your agent 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.
trpc-group/trpc-agent-go · examples/agui/server/skill_artifacts/skills/artifact_demo/SKILL.md · Demo skill that writes an output file and persists it as an artifact.
trpc-group/trpc-agent-go · examples/dynamicworkflow/skills/skills/fanout-analysis/SKILL.md · Use this workflow recipe when a question benefits from several independent perspectives followed by a single…
trpc-group/trpc-agent-go · examples/dynamicworkflow/skills/skills/quality-loop/SKILL.md · Use this workflow recipe when a draft, plan, proposal, or other deliverable should be independently reviewed and…
trpc-group/trpc-agent-go · examples/mcpbroker/basic/skills/remote-http-mcp/SKILL.md · Connect to a remote streamable HTTP MCP service that exposes announcements and FAQ tools.
trpc-group/trpc-agent-go · examples/skilldynamicschema/skills/plan_route/SKILL.md · Plan a route and return distance + ETA (schema + deterministic result).
zapier/connectors · apps/notion/SKILL.md · Agent-callable Notion tools for searching pages and databases, reading and creating pages, querying data sources…
openhands/extensions · skills/notion/SKILL.md · Create, search, and update Notion pages/databases using the Notion API. Use for documenting work, generating runbooks…
