Claude MarketplacesSubmit
makenotion avatar

Notion Cli

makenotion/skillsOfficial

A self-documenting CLI for the Notion API that's smart about discovery. Instead of memorizing syntax, you run `ntn api ls` to see every endpoint or `ntn api <path> --help` for usage details. The standout feature is native Markdown support for pages and comments, so you can skip wrestling with Notion's rich_text blocks most of the time. It also handles file uploads and worker deployments. Authentication works via environment variable or interactive login. Useful when you're building integrations or automating Notion workflows and want something more direct than SDK abstractions. The help flags do most of the heavy lifting here.

skills.sh installs
9K
GitHub stars
183
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add makenotion/skills --skill notion-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

Notion CLI

Look things up before answering

The CLI is self-documenting. Always prefer running these commands over guessing syntax or relying on memorized knowledge:

  • ntn api ls — list every public API endpoint.
  • ntn api <path> --help — show methods, doc links, and usage for an endpoint.
  • ntn api <path> --docs — print the full official docs for an endpoint.
  • ntn api <path> --spec — print a reduced OpenAPI fragment (useful for understanding request/response schemas).
  • ntn pages get <page-id> — retrieve a page as Markdown. Use this to read page content.
  • ntn <command> --help — help for any command or subcommand.

Install

curl -fsSL https://ntn.dev | bash

Authentication

  • The CLI automatically uses NOTION_API_TOKEN when it is set.
  • Check NOTION_API_TOKEN first. If it is already set, prefer using it instead of telling the user to run ntn login.
  • ntn login / ntn logout — log the CLI in or out (only use if not using NOTION_API_TOKEN). ntn login requires the user to visit a URL in a web browser.

ntn api

Run ntn api --help for full syntax. Quick summary:

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/makenotion/skills
Categories
Backend & APIs, DevOps & CI/CD, Release Management, CLI & Terminal, Office & Documents, Databases
First seen
Apr 16, 2026

Recommended

More Backend & APIs
1onmax avatarnuxtonmax/nuxt-skillsNuxt application development and maintenance. Use for project structure, pages and routing, data fetching, SSR-safe state, middleware, plugins, server routes, r8.8Kskills.sh installs
2emblemcompany avataremblem-ai-reactemblemcompany/agent-skillsReact integration skill for EmblemAI's one-shot user management. Use when the user wants to add website authentication plus wallet-enabled users to a React app 8.8Kskills.sh installs
3jeffallan avatarspring-boot-engineerjeffallan/claude-skillsGenerates Spring Boot 3.x configurations, creates REST controllers, implements Spring Security 6 authentication flows, sets up Spring Data JPA repositories, and8.7Kskills.sh installs
4github avatarcopilot-usage-metricsgithub/awesome-copilotRetrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI and REST API.8.7Kskills.sh installs
5flutter avatarflutter-handling-http-and-jsonflutter/skillsHTTP requests and JSON serialization for Flutter REST API integration and data parsing.8.7Kskills.sh installs
6nomadamas avatarg2b-sanctioned-suppliernomadamas/k-skill조달청 나라장터 부정당제재업체정보를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 사업자등록번호 정확 일치로 조회시점 현재 유효한 입찰참가자격 제한(부정당제재)의 기간·제재기관·근거법률을 확인한다.8.7Kskills.sh installs