Agent skill

Notion

by win4r in win4r/MuseAI-Skills

Search, read, create, and update Notion pages via the Notion MCP.

No licenceAuto-check passedAgent Workflows

Install Notion

skills CLI
$ npx skills add win4r/MuseAI-Skills --skill notion -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install win4r/MuseAI-Skills notion --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/win4r/MuseAI-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/opt/hatch/skills/notion .claude/skills/notion && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notion
GitHub stars
336
Used in
1 other repo
Token cost
~656 tokens
SKILL.md length
301 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
None found

At a glance

Search, read, create, and update Notion pages via the Notion MCP.

  • Works in 4 steps: Run notion-cli status. → If status is not_connected, run… → After the user authorizes, the browser… → …
  • Tasks that involve MCP servers
  • SKILL.md covers Purpose, Tooling, Auth and First-use setup flow, plus 1 more section
  • Reaches mcp.notion.com

What it does

Notion is an agent skill from win4r/MuseAI-Skills. Search, read, create, and update Notion pages via the Notion MCP.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `manifest.yaml`).

It sits in Agent Workflows, covering MCP servers. It works with Notion and Model Context Protocol. The repository describes itself as: muse.ai (Muse AI) skills and runtime snapshot: 68 skills, workflow guides, connector manifests. muse.ai 技能与运行环境文件;非官方存档 / Unofficial archive.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/notion”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run notion-cli status.
  2. If status is not_connected, run notion-cli authorize-url. When
  3. After the user authorizes, the browser is redirected via the Muse relay
  4. Re-run notion-cli status. When status flips to connected the output also

What it can do on your machine

Read from SKILL.md and the folder at commit 38bbb45. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mcp.notion.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion loads about 656 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 301 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~656

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 301 words (~656 tokens).

“Interact with Notion pages, databases, and workspace content via the hosted Notion MCP server (https://mcp.notion.com/mcp).”

— opening of SKILL.md by win4r
name
notion
icon
notion
metadata.includeInPrompt
false

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in opt/hatch/skills/notion of win4r/MuseAI-Skills.

  • SKILL.md
  • manifest.yaml

Open the folder on GitHubat commit 38bbb45

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in win4r/MuseAI-Skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Notion next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notion compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion this skillwin4r/MuseAI-Skills3361 repos~656Automated safety check: PassNone
Easy Notion CLIFR0ZON3/notion-mcp118—~2kAutomated safety check: PassMIT
Superset Integration Toolssuperset-sh/superset15k—~1.6kAutomated safety check: WarnCustom licence
Adding MCP Store ServersPostHog/posthog40k—~1.6kAutomated safety check: PassCustom licence
Integrate MCPdavekilleen/Dex493—~2.2kAutomated safety check: NotesMIT
Dev MCP Setupevolution-foundation/evo-nexus545—~615Automated safety check: PassCustom licence

Similar skills

  • Easy Notion CLI

    FR0ZON3/notion-mcp

    A skill your agent uses when Codex or agents need to use Notion through the easy-notion CLI instead of loading MCP tools, especially for low-context Notion access, multi-profile workspace/account…

    118 GitHub stars~2k tokensUpdated 25 days ago
    Agent WorkflowsAuto-check passed
  • Superset Integration Tools

    superset-sh/superset

    Lists and calls the tools of connected integrations such as Linear, GitHub, Sentry or Notion through the superset mcp command, without storing a token on the machine.

    15k GitHub stars~1.6k tokensUpdated today
    Agent WorkflowsAuto-check: warnings
  • Official

    Add a third-party MCP server (Linear, Notion, GitHub, ...) to the PostHog MCP store catalog.

    40k GitHub stars~1.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Integrate MCP

    davekilleen/Dex

    Install and wire up an existing MCP server from Smithery.ai or a GitHub repo.

    493 GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Dev MCP Setup

    evolution-foundation/evo-nexus

    Configure MCP servers for the workspace — web search, filesystem, GitHub, Stripe, etc.

    545 GitHub stars~615 tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Docs Tooling Notion

    langchain-ai/docs

    Official

    Document new or changed docs-team tooling on the Notion tooling pages.

    426 GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed

More from win4r/MuseAI-Skills

All 25 skills in this repo
  • Withings Health Data Reader

    win4r/MuseAI-Skills

    Reads Withings body measurements, daily activity, sleep sessions and workouts through a bundled withings command line tool and returns typed JSON records.

    336 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Travel and Event Booking

    win4r/MuseAI-Skills

    Handles direct flight, hotel, restaurant and event-ticket bookings and live availability checks, loading the right category reference before searching or booking.

    336 GitHub starsUsed in 1 repo~4k tokens
    Auto-check passed
  • HealthEx Health Records

    win4r/MuseAI-Skills

    Connects to HealthEx through OAuth and its MCP server so you can ask about medications, lab results, conditions and other health records.

    336 GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • Product Shopping Search

    win4r/MuseAI-Skills

    Guides an agent through product searches across a catalog, a browser agent and Facebook Marketplace, favoring low prices and citing each product it names.

    336 GitHub starsUsed in 1 repo~9.1k tokens
    Auto-check passed
  • Muse Feedback Filer

    win4r/MuseAI-Skills

    Tells the agent when to offer, and how to file, a feature request or bug report with the Muse team through a feature-request command line tool, only with your approval.

    336 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: warnings
  • Duffel Flight Booking

    win4r/MuseAI-Skills

    Defines how an agent searches, books and manages flights through the Duffel CLI, and watches a booked fare when you ask for ongoing price monitoring.

    336 GitHub starsUsed in 1 repo~7k tokens
    Auto-check passed

Categories

Questions about Notion

What does Notion do?

Search, read, create, and update Notion pages via the Notion MCP. Notion is an agent skill from win4r/MuseAI-Skills. Search, read, create, and update Notion pages via the Notion MCP.

When should I use Notion?

Notion fits situations like: tasks that involve MCP servers.

How do I install Notion in Claude Code?

Run `npx skills add win4r/MuseAI-Skills --skill notion -a claude-code`. Or copy the skill folder (opt/hatch/skills/notion in win4r/MuseAI-Skills) into .claude/skills/notion in your project. Claude Code loads it when a task matches its description.

How do I install Notion in Codex?

Run `npx skills add win4r/MuseAI-Skills --skill notion -a codex`. Or copy the skill folder (opt/hatch/skills/notion in win4r/MuseAI-Skills) into .agents/skills/notion in your project. Codex loads it when a task matches its description.

Can I use Notion in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add win4r/MuseAI-Skills --skill notion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion, .gemini/skills/notion, .github/skills/notion and .opencode/skills/notion in your project.

What does Notion need to run?

SKILL.md names no scripts, command-line tools or credentials: Notion is instructions for the agent only.

Does Notion access the network?

SKILL.md names 1 domain. In commands or code: mcp.notion.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Notion safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notion use?

No licence was found for Notion or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Notion use?

About 656 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notion?

Skills that share tags, products or a category with Notion: Easy Notion CLI (FR0ZON3/notion-mcp, 118 stars), Superset Integration Tools (superset-sh/superset, 15k stars), Adding MCP Store Servers (PostHog/posthog, 40k stars) and Integrate MCP (davekilleen/Dex, 493 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion?

win4r (a GitHub user) maintains it in win4r/MuseAI-Skills, which has 336 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 28, 2026.

Source: win4r/MuseAI-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.