Notion

Name: Notion
Author: steipete

steipete/clawdis

3.2k installs
385k repo stars
Updated August 3, 2026
steipete/clawdis

notion is an OpenClaw skill that drives the official ntn CLI for Markdown pages, data source queries, file uploads, and raw Notion API calls.

About

The Notion skill guides agents through the official ntn CLI for pages, databases, data sources, files, comments, search, Workers, and raw API calls. Setup covers npm global install, interactive ntn login, or headless NOTION_API_TOKEN with NOTION_API_VERSION 2026-03-11. Markdown-first page helpers include pages get with frontmatter properties, pages create and update from content strings or stdin, and pages trash with confirmation. Data source commands resolve database IDs, query with filters and sorts, and return JSON for agent parsing. Raw API access uses path=value body fields, typed path:=json values, query parameters, and schema or docs inspection before constructing payloads. File uploads support stdin binary, external URLs, and upload listing. Workers commands cover new, deploy, list, and run logs where the workspace plan allows. A curl fallback documents Authorization and Notion-Version headers when ntn is unavailable.

Official ntn CLI preferred over curl with automatic auth and version headers.
Markdown-first pages get, create, update, and trash workflows.
Data source resolve and filtered query with JSON output.
Raw API helper with schema and docs inspection before payload build.
File upload via stdin, external URL, or upload ID retrieval.

Notion by the numbers

3,158 all-time installs (skills.sh)
+160 installs in the week ending Aug 2, 2026 (Skillselion tracking)
Ranked #143 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
Security screen: LOW risk (skills.sh audit)
Data as of Aug 3, 2026 (Skillselion catalog sync)

At a glance

notion capabilities & compatibility

Capabilities: markdown page get, create, update, and trash · database to data source resolve and filtered que · raw api with schema and docs inspection · binary and external url file uploads · workspace search and user endpoints · workers deploy and run log inspection
Works with: notion
Use cases: documentation · project management · orchestration
Pricing: Free

npx skills add https://github.com/steipete/clawdis --skill notion

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/steipete/clawdis/notion.svg)](https://skillselion.com/skills/steipete/clawdis/notion)

Installs	3.2k
repo stars	★ 385k
Security audit	3 / 3 scanners passed
Last updated	August 3, 2026
Repository	steipete/clawdis ↗

How should an agent create, query, and update Notion pages and databases without guessing API version fields or parent references?

Manage Notion pages, data sources, files, search, and raw API calls through the official ntn CLI with Markdown-first helpers.

Who is it for?

Teams automating Notion docs and databases through the official CLI with schema-first raw API safety.

Skip if: Skip when the workspace lacks NOTION_API_TOKEN or ntn install and no alternative auth is available.

When should I use this skill?

User asks to read, create, update, search, or upload content in Notion via ntn or the Notion API.

What you get

Executed ntn commands with Markdown page output, filtered query results, uploaded files, or validated raw API responses.

Notion page and database updates
API-driven workspace search results

Files

SKILL.mdMarkdownGitHub ↗

Notion

Prefer official ntn CLI. Use curl only when ntn is unavailable or a raw request is clearer.

Setup

npm install -g ntn
ntn --version
ntn login

Script/headless auth:

export NOTION_API_TOKEN=secret_or_ntn_token
export NOTION_API_VERSION=2026-03-11

ntn api sets Authorization and Notion-Version automatically. It uses CLI login by default, or NOTION_API_TOKEN when set.

Inspect

ntn doctor
ntn api ls
ntn api ls --json
ntn api v1/comments --help
ntn api v1/comments --spec -X POST
ntn api v1/comments --docs -X POST

Pages

Markdown-first helpers:

ntn pages get <page-id>
ntn pages get <page-id> --json
ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
ntn pages create --parent data-source:<data-source-id> < page.md
ntn pages update <page-id> --content '# Updated'
ntn pages update <page-id> < page.md
ntn pages trash <page-id> --yes

Notes:

pages get prints Markdown with page properties as frontmatter.
Content input: --content, stdin, or editor in a TTY.
Parent refs: page:<id>, database:<id>, data-source:<id>.
For properties/templates/full Pages API, use ntn api v1/pages.

Data sources

ntn datasources resolve <database-id>
ntn datasources resolve <database-id> --json
ntn datasources query <data-source-id>
ntn datasources query <data-source-id> --limit 50 --json
ntn datasources query <data-source-id> --sort 'Date desc'
ntn datasources query <data-source-id> --filter '{"property":"Done","checkbox":{"equals":true}}'

Use resolve when you have a database ID. Query needs a data source ID.

Raw API

ntn api v1/users/me
ntn api v1/search query=roadmap page_size:=10
ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[Name][title][0][text][content]=New item'
ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
  'children[0][type]=paragraph' \
  'children[0][paragraph][rich_text][0][text][content]=Hello'

Input syntax:

path=value: string body field.
path:=json: typed JSON body field.
name==value: query parameter.
Header:Value: request header.
--data '<json>' or stdin JSON for larger bodies.
Only one body source per request.

Files

ntn files create < image.png
ntn files create --filename photo.png --content-type image/png < /tmp/photo
ntn files create --external-url https://example.com/photo.png
ntn files get <upload-id>
ntn files list

Workers

ntn workers new
ntn workers deploy
ntn workers list --json
ntn workers runs list --json
ntn workers runs logs <run-id>

Workers may require Business/Enterprise plan and workspace enablement.

Curl fallback

curl -sS "https://api.notion.com/v1/users/me" \
  -H "Authorization: Bearer $NOTION_API_TOKEN" \
  -H "Notion-Version: 2026-03-11" \
  -H "Content-Type: application/json"

Version notes

Current latest API version: 2026-03-11.
Use in_trash, not archived.
Append block positioning uses position, not flat after.
transcription block renamed to meeting_notes.
Databases can contain multiple data sources; page parents generally use data_source_id.