skills.rest
JEROME-PRAKASH-L
JEROME-PRAKASH-LCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

notion

Manage Notion pages, data sources, files, and comments via the ntn CLI and Notion API.

1|Updated Jun 9, 2026
Search Tags:#markdown#api#cli#notion#database query#pages#workspace automation
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill notion-jerome-prakash-l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/notion
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill notion-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ntn.

What problem does it solve? Working with Notion programmatically requires juggling raw REST API calls, authentication headers, and version-specific quirks. This Skill wraps the official ntn CLI and curl fallback into clear commands for creating pages, querying data sources, uploading files, and calling any Notion API endpoint. ## Core Features & Use Cases - Markdown-first page management: Get, create, update, and trash Notion pages using Markdown content with properties as frontmatter. - Data source queries: Resolve database IDs to data sources and run filtered, sorted queries against them. - Raw API access and files: Call any Notion API endpoint with typed JSON body syntax, upload files, and manage Cloudflare Workers integrations. - Use Case: You want to publish a weekly report into a Notion database. Use the Skill to resolve the database ID, query existing entries, and create a new page from a Markdown file with a single command. ## Quick Start Use the notion skill to create a new page under my team wiki containing the meeting notes from today.

Frequently Asked Questions about notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Notion page from the command line?▼

Use ntn pages create with a parent reference like page:<id> or data-source:<id> and supply content via --content, stdin, or an editor. The CLI accepts Markdown and sets page properties as frontmatter.

How do I query a Notion database with filters?▼

First run ntn datasources resolve with your database ID to get the data source ID, then run ntn datasources query with --filter JSON and optional --sort or --limit flags. Query requires a data source ID, not a database ID.

Can I use the Notion API without installing the ntn CLI?▼

Yes, use curl with an Authorization Bearer header containing NOTION_API_TOKEN and a Notion-Version header set to 2026-03-11. The ntn CLI is preferred but curl works for any raw request.

How do I authenticate the Notion CLI for headless scripts?▼

Export NOTION_API_TOKEN with your integration token and optionally NOTION_API_VERSION. The ntn api command uses CLI login by default but falls back to NOTION_API_TOKEN when the variable is set.

Why does my Notion API call fail with archived or after parameters?▼

The current API version 2026-03-11 renamed several fields: use in_trash instead of archived, position instead of flat after for block appends, and meeting_notes instead of transcription. Check the version notes before writing raw calls.

Related Skills

Explore More Product & Management Skills→
ariffazilariffazil
2

notion

Manage Notion pages and databases via the official API.

Community
Intermediate
jjub0217jjub0217

context-sync

Collect GitHub PRs, issues, commits, and Notion tasks into a sync document.

Community
Advanced
syl2042syl2042

notion-meeting-intelligence

Generate Notion meeting agendas with Codex-enriched pre-reads and linked source materials.

Community
Advanced
microsoftmicrosoft
221

shell-use

Automate terminal sessions and assert outputs against expected results.

Official
Advanced