SkillFoxx

Notion Skills

Official Notion skills: notion-cli teaches agents the ntn commands for the API and files, notion-apps scaffolds Notion Apps.

  • 184 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The `notion-cli` skill writes pages and comments, uploads files and deploys workers in your workspace. Start with an integration token connected to a single test page.
All reasons and checks

makenotion/skillsAuthor:Notion

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/notion-skills

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The `notion-cli` skill writes pages and comments, uploads files and deploys workers in your workspace. Start with an integration token connected to a single test page.

This is third-party code. Review the repository files before installing.

What it does

Notion Skills are two skills from Notion itself. The `notion-cli` skill explains how an agent works through the `ntn` CLI: call the public API (`ntn api`), read a page as Markdown (`ntn pages get`), create and update pages, upload files (`ntn files`) and manage workers (`ntn workers`). The agent reads the built-in CLI help to confirm syntax. The `notion-apps` skill starts a Notion Apps project: it checks that `ntn` is installed, scaffolds with `ntn apps new --install --git <directory>` and sends the agent to read `AGENTS.md` in the generated project. Before work the skill asks the user to confirm participation in the Notion Apps alpha.

Who it is for. Developers and analysts whose data lives in Notion and who want Claude Code or Codex to read databases, write pages and deploy workers.

Good fit when

  • An agent must read a Notion page as Markdown and summarize it in chat.
  • A page or a formatted comment must be created through the public API.
  • Files from a local folder go into a Notion database.
  • A team writes a Notion worker and deploys it with `ntn workers deploy`.
  • A Notion Apps alpha participant starts a new project from a scaffold.

Not a fit when

  • The agent connects to Notion as an MCP server: a separate official MCP exists for that.
  • Notion Apps development is planned without alpha access: code builds locally but deployment is impossible.
  • Agent access to the workspace is undesirable: an integration token opens the pages and databases it is connected to.

Example request

Use ntn to read the release plan page and add a comment below it with the three main concerns.

Limitations

The skills do not work without the `ntn` CLI, installed with `curl -fsSL https://ntn.dev | bash` on macOS and Linux or `winget install Notion.ntn` on Windows. The API needs authentication: the `NOTION_API_TOKEN` variable or `ntn login` with a browser sign-in link. The `notion-apps` skill requires participation in the Notion Apps alpha, which CLI authentication or a local SDK build does not prove. The `ntn apps` command may be hidden and is enabled with `ntn experiments enable apps`. Skill descriptions are in English.

How to disable. Delete the `notion-cli` and `notion-apps` folders from the agent skills directory. Remove `NOTION_API_TOKEN` from the environment, sign out with `ntn logout` and disconnect the integration in Notion settings.

FAQ

How do I install the official Notion skills?

Run `npx skills add makenotion/skills` for both skills or `npx skills add makenotion/skills --skill notion-cli` for one. Installation goes through the skills CLI.

What is ntn?

The Notion command-line tool. The skill uses it to call the public API, read and create pages, upload files and manage workers. Help is built in: `ntn api ls` and `ntn <command> --help`.

How do I authenticate ntn?

Set the `NOTION_API_TOKEN` variable and the CLI uses it on its own. Without a token run `ntn login` and open the link it prints in a browser.

Is alpha access needed for notion-apps?

Yes. The skill first asks you to confirm Notion Apps alpha participation. Without it project code builds locally but cannot be deployed.

What does the notion-apps skill do?

It checks that `ntn` is installed, creates a project with `ntn apps new --install --git <directory>` and sends the agent to read the `AGENTS.md` of the new project.

Discussion

No questions or reviews yet.

Skills

A CLI that keeps agent skills in a Notion database: browse a shared store, install the ones you need, sync and publish for a team

CLIExtended access79

Twenty-two standalone skills: Notion, Todoist, Tavily, Context7, image generation, converting documents to Markdown

SkillBroad access302

Notion MCP (awkoy)

Notion MCP Server (awkoy)

Notion MCP on a token: an agent searches pages, runs databases, edits blocks and comments through three tools and 47 operations, with no manual sign-in

MCP serverBroad access180
Official

The official Notion plugin for Claude Code: four skills, ten slash commands and a connected MCP server in a single install

PluginBroad access504

A Notion MCP server: the agent searches, reads, queries and updates workspace pages and databases

MCP serverBroad access925

A collection of skills for decisions and projects: strategy, market research, thinking, data analysis, docs and slides.

PluginMinimal access109

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Notion Skills (this card)no184
Notion MCP ServeryesAPI key4,706gives an agent Notion access through an MCP server; here the agent drives the ntn console tool from skill instructions
Notion Plugin for Claude Codeyes504a Claude Code plugin for Notion; these are skills for any agent supporting the skills format, plus Notion Apps projects

README in short

The README is short: the recommended install via the skills CLI and a table of two skills with descriptions. Details live in the SKILL.md files themselves.

README badge

Original SKILL.md

---
name: notion-cli
description: >-
  Use the Notion CLI (`ntn`) to interact with the Notion API, manage workers,
  and upload files. Use when the user asks to "call the Notion API", "deploy a
  worker", "upload a file to Notion", "create a page", "query a database", or
  any task involving the `ntn` command.
---

# 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

```bash
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:

```bash

Report a problem