johnson7788/multiuserclaw/notion
Claude Code and agent skill by johnson7788/multiuserclaw
- community
Checking that the SKILL.md file is still in the repository.
Notion API + ntn CLI: pages, databases, markdown, Workers.
Install
npx vskill@latest install johnson7788/multiuserclaw/notionSKILL.md
The same SKILL.md was published earlier as johnson7788/multiuserclaw/notion.
Notion
Talk to Notion two ways. Same integration token works for both — pick by what's available.
◆ `ntn` CLI — Notion's official CLI. Shorter syntax, one-line file uploads, required for Workers. macOS + Linux only as of May 2026 (Windows support "coming soon"). Default when installed. ◆ HTTP + curl — works everywhere including Windows. Default fallback when ntn isn't installed.
Setup
1. Get an integration token (required for both paths)
- Create an integration at https://notion.so/my-integrations
- Copy the API key (starts with
ntn_orsecret_) - Store in
${HERMES_HOME:-~/.hermes}/.env:
`` NOTION_API_KEY=ntn_your_key_here ``
- Share target pages/databases with the integration in Notion: page menu
...→Connect to→ your integration name. Without this, the API returns 404 for that page even though it exists.
2. Install ntn (preferred path on macOS / Linux)
Skip `ntn login` — use the integration token instead. This works headlessly, no browser needed:
Add those exports to your shell profile (or to ${HERMES_HOME:-~/.hermes}/.env) so every session inherits them.
3. Choose path at runtime
Windows users: skip step 2 entirely until native ntn ships — Path B works fine. If you want CLI ergonomics now, install ntn inside WSL2.
API Basics
Notion-Version: 2025-09-03 is required on all HTTP requests. ntn handles this for you. In this version, what users call "databases" are called data sources in the API.
Path A — ntn CLI (preferred, macOS / Linux)
Raw API calls (shorthand for curl)
Syntax notes:
key=value— string fieldskey[nested]=value— nested object fieldskey:=value— typed assignment (booleans, numbers, null, arrays)
Search
Read page metadata
Read page as Markdown (agent-friendly)
Read page content as blocks
Create page from Markdown
Patch a page with Markdown
Query a database (data source)
For complex queries with sorts, multiple filter clauses, or compound logic, pipe JSON in:
File uploads (one-liner — biggest CLI win)
Compare to the 3-step HTTP flow (create upload → PUT bytes → reference).
Useful env vars
| Var | Effect | |
|---|---|---|
NOTION_API_TOKEN | Auth token (overrides keychain) — set this to your integration token | |
NOTION_KEYRING=0 | File-based creds at ~/.config/notion/auth.json instead of OS keychain | |
NOTION_WORKSPACE_ID | Skip the workspace picker prompt |
Path B — HTTP + curl (cross-platform, default on Windows)
All requests share this pattern:
On Windows the curl shipped with Windows 10+ works as-is. PowerShell users can also use Invoke-RestMethod.
Search
Read page metadata
Read page as Markdown (agent-friendly)
Easier to feed to a model than block JSON.
Read page content as blocks (when you need structure)
Create page from Markdown
POST /v1/pages accepts a markdown body param.
Patch a page with Markdown
Create page in a database (typed properties)
Query a database (data source)
Create a database
Update page properties
Append blocks to a page
File uploads (3-step flow)
Property Types
Common property formats for database items:
- Title:
{"title": [{"text": {"content": "..."}}]} - Rich text:
{"rich_text": [{"text": {"content": "..."}}]} - Select:
{"select": {"name": "Option"}} - Multi-select:
{"multi_select": [{"name": "A"}, {"name": "B"}]} - Date:
{"date": {"start": "2026-01-15", "end": "2026-01-16"}} - Checkbox:
{"checkbox": true} - Number:
{"number": 42} - URL:
{"url": "https://..."} - Email:
{"email": "user@example.com"} - Relation:
{"relation": [{"id": "page_id"}]}
API Version 2025-09-03 — Databases vs Data Sources
- Databases became data sources. Use
/data_sources/endpoints for queries and retrieval. - Two IDs per database:
database_idanddata_source_id. database_idwhen creating pages:parent: {"database_id": "..."}data_source_idwhen querying:POST /v1/data_sources/{id}/query- Search returns databases as
"object": "data_source"with thedata_source_idfield.
Notion Workers (advanced, requires ntn)
Workers are TypeScript programs Notion hosts for you. One worker can expose any combination of:
- Syncs — pull data from external APIs into a Notion database on a schedule (default 30 min).
- Tools — appear as callable tools inside Notion's Custom Agents.
- Webhooks — receive HTTP events from external services (GitHub, Stripe, etc.) and act in Notion.
Plan / platform gating:
- CLI works on all plans. Deploying Workers requires Business or Enterprise.
ntnis macOS/Linux only as of May 2026. Windows users need WSL2 or to wait for native support.- Free through August 11, 2026; metered on Notion credits after.
Minimal Worker
src/index.ts:
Webhook capability
After deploy: ntn workers webhooks list shows the URL Notion generates. Treat that URL as a secret — anyone with it can POST events unless you add signature verification.
Worker lifecycle commands
When asked to build a Worker, scaffold with ntn workers new, write the code in src/index.ts, set any secrets with ntn workers env set, and deploy. Notion's docs at https://developers.notion.com/workers cover the full API surface.
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckinghermes-agent/skills/productivity/notion/SKILL.md
Popularity
- Repository stars
- 290
- Repository forks
- 86
- 7-day trend score
- 28
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/johnson7788/multiuserclaw/notion)