New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Notion MCP Skill

by holon-run in holon-run/uxc

Operate Notion workspace content through Notion MCP using the UXC CLI, including search, fetch, users/teams lookup, page/database creation and updates, and comments.

MITAuto-check passedBackend & APIs

Install Notion MCP Skill

skills CLI
$ npx skills add holon-run/uxc --skill notion-mcp-skill -a claude-code

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

GitHub CLI
$ gh skill install holon-run/uxc notion-mcp-skill --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/holon-run/uxc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/notion-mcp-skill .claude/skills/notion-mcp-skill && 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-mcp-skill
GitHub stars
116
Token cost
~1.2k tokens
SKILL.md length
516 words
Files
6 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Operate Notion workspace content through Notion MCP using the UXC CLI, including search, fetch, users/teams lookup, page/database creation and updates, and comments.

  • Works in 7 steps: Ensure endpoint mapping exists → If mapping/auth is not ready, start… → Bind endpoint to the credential → …
  • Tasks require calling Notion tools over MCP with OAuth (authorizationcode + PKCE)
  • SKILL.md covers Prerequisites, Core Workflow (Notion-Specific), OAuth Interaction Template and Guardrails, plus 1 more section
  • Runs Shell scripts from its folder; reaches mcp.notion.com and notion.so

What it does

Notion MCP Skill is an agent skill from holon-run/uxc. Operate Notion workspace content through Notion MCP using the UXC CLI, including search, fetch, users/teams lookup, page/database creation and updates, and comments. Use when tasks require calling Notion tools over MCP with OAuth (authorizationcode + PKCE), especially when safe write controls and JSON-envelope parsing are required.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/error-handling.md` and `references/oauth-and-binding.md`).

It sits in Backend & APIs, covering OAuth and OpenID Connect, MCP servers and Authorization and RBAC. It works with Notion and Model Context Protocol. The repository describes itself as: A unified CLI for discovering and invoking tools across OpenAPI, MCP, GraphQL, gRPC, and JSON-RPC. The licence is MIT.

When your agent uses it

  • Tasks require calling Notion tools over MCP with OAuth (authorizationcode + PKCE)
  • Especially when safe write controls and JSON-envelope parsing are required

Example prompts

  • “/notion-mcp-skill”

Requirements

  • A Bash shell

Workflow steps

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

  1. Ensure endpoint mapping exists
  2. If mapping/auth is not ready, start OAuth login
  3. Bind endpoint to the credential
  4. Use fixed link command by default
  5. Discover tools and inspect schema before execution
  6. Prefer read path first
  7. Execute writes only after explicit user confirmation

What it can do on your machine

Read from SKILL.md and the folder at commit 562d47c. 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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    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
    • notion.so

    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 MCP Skill loads about 1.2k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 88 tokens; SKILL.md has 516 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from holon-run/uxc at commit 562d47c, republished under its MIT licence (© holon-run). 516 words, ~1,175 tokens.

Download SKILL.mdSave it as .claude/skills/notion-mcp-skill/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
notion-mcp-skill
description
Operate Notion workspace content through Notion MCP using the UXC CLI, including search, fetch, users/teams lookup, page/database creation and updates, and comments. Use when tasks require calling Notion tools over MCP with OAuth (authorization_code + PKCE), especially when safe write controls and JSON-envelope parsing are required.

Notion MCP Skill

Use this skill to run Notion MCP operations through uxc with OAuth and guarded write behavior.

Reuse the uxc skill guidance for discovery, schema inspection, OAuth lifecycle, and error recovery. Do not assume another skill is auto-triggered in every runtime. Keep this skill executable on its own.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to https://mcp.notion.com/mcp.
  • OAuth callback listener is reachable (default examples use http://127.0.0.1:8788/callback).
  • uxc skill is available for generic discovery/describe/execute patterns.

Core Workflow (Notion-Specific)

Endpoint argument style in this skill:

  • Prefer shorthand mcp.notion.com/mcp (scheme omitted).
  • Full URL https://mcp.notion.com/mcp is also valid.
  1. Ensure endpoint mapping exists:
    • uxc auth binding match mcp.notion.com/mcp
  2. If mapping/auth is not ready, start OAuth login:
    • uxc auth oauth start notion-mcp --endpoint mcp.notion.com/mcp --redirect-uri http://127.0.0.1:8788/callback --scope read --scope write
    • Prompt user to open the printed authorization URL.
    • Ask user to paste the full callback URL after consent.
    • Complete login with uxc auth oauth complete notion-mcp --session-id <session_id> --authorization-response '<callback-url>'
  3. Bind endpoint to the credential:
    • uxc auth binding add --id notion-mcp --host mcp.notion.com --path-prefix /mcp --scheme https --credential notion-mcp --priority 100
  4. Use fixed link command by default:
    • command -v notion-mcp-cli
    • If missing, create it: uxc link notion-mcp-cli mcp.notion.com/mcp
    • notion-mcp-cli -h
    • If command conflict is detected and cannot be safely reused, stop and ask skill maintainers to pick a different fixed command name.
  5. Discover tools and inspect schema before execution:
    • notion-mcp-cli -h
    • notion-mcp-cli notion-fetch -h
    • notion-fetch requires id (URL or UUID). Examples:
      • notion-mcp-cli notion-fetch id="https://notion.so/your-page-url"
      • notion-mcp-cli notion-fetch id="12345678-90ab-cdef-1234-567890abcdef"
    • Common operations include notion-search, notion-fetch, and notion-update-page.
  6. Prefer read path first:
    • Search/fetch current state before any write.
  7. Execute writes only after explicit user confirmation:
    • For notion-update-page operations that may delete content, always confirm intent first.
Show full SKILL.md (228 more words)Show less

OAuth Interaction Template

Use this exact operator-facing flow:

  1. Start login command and wait for authorization URL output.
  2. Tell user:
    • Open this URL in browser and approve Notion access.
    • Copy the full callback URL from browser address bar.
    • Paste the callback URL back in chat.
  3. Run uxc auth oauth complete notion-mcp --session-id <session_id> --authorization-response '<callback-url>'.
  4. Optionally confirm success with:
    • uxc auth oauth info <credential_id>

Do not ask user to manually extract or copy bearer tokens. Token exchange is handled by uxc. Use uxc auth oauth login ... --flow authorization_code only for a single-process interactive fallback.

Guardrails

  • Keep automation on JSON output envelope; do not use --text.
  • Parse stable fields first: ok, kind, protocol, data, error.
  • Use notion-mcp-cli as the default command path for all Notion MCP calls in this skill.
  • notion-mcp-cli <operation> ... is equivalent to uxc mcp.notion.com/mcp <operation> ....
  • Use direct uxc mcp.notion.com/mcp ... only as a temporary fallback when link setup is unavailable.
  • Call notion-fetch before notion-create-pages or notion-update-page when targeting database-backed content to obtain exact schema/property names.
  • Treat operations as high impact by default:
    • Require explicit user confirmation before create/update/move/delete-style actions.
  • If OAuth/auth fails, use uxc skill OAuth/error playbooks first, then apply Notion-specific checks in this skill's references.

References

  • Notion-specific auth notes (thin wrapper over uxc skill OAuth guidance):
    • references/oauth-and-binding.md
  • Invocation patterns by task:
    • references/usage-patterns.md
  • Notion-specific failure notes (thin wrapper over uxc skill error guidance):
    • references/error-handling.md

© holon-run, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/notion-mcp-skill of holon-run/uxc.

  • SKILL.md
  • agents/openai.yaml
  • references/error-handling.md
  • references/oauth-and-binding.md
  • references/usage-patterns.md
  • scripts/validate.sh

Open the folder on GitHubat commit 562d47c

Compare with similar skills

Notion MCP Skill 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 MCP Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion MCP Skill this skillholon-run/uxc116—~1.2kAutomated safety check: PassMIT
Flexport Enterprise Rbacjeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
Adding MCP Store ServersPostHog/posthog40k—~1.6kAutomated safety check: PassCustom licence
Xquik MCPXquik-dev/x-twitter-scraper2111 repos~997Automated safety check: PassMIT
Tenuo Agent Authorizationtenuo-ai/tenuo103—~2.3kAutomated safety check: PassApache-2.0
Frontmcp Auth UIagentfront/frontmcp146—~3.7kAutomated safety check: PassApache-2.0

Similar skills

  • Flexport Enterprise Rbac

    jeremylongshore/tons-of-skills-marketplace

    Map Flexport endpoint-scoped OAuth credentials and MCP role permissions to approved workloads.

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Adding MCP Store Servers

    PostHog/posthog

    Official

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

    40k GitHub stars~1.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

  • Xquik MCP

    Xquik-dev/x-twitter-scraper

    Connect, verify, and troubleshoot Xquik's remote MCP server.

    211 GitHub starsUsed in 1 repo~997 tokens
    Backend & APIsAuto-check passed

  • Tenuo Agent Authorization

    tenuo-ai/tenuo

    Add or retrofit Tenuo authorization for AI-agent tools and effects.

    103 GitHub stars~2.3k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Frontmcp Auth UI

    agentfront/frontmcp

    A skill your agent uses when customizing, branding, or replacing the built-in FrontMCP OAuth pages (the login, consent, federated-select, incremental-authorization, and error pages) with your own…

    146 GitHub stars~3.7k tokensUpdated today
    Backend & APIsAuto-check passed

  • MCP Dart Streamable HTTP

    leehack/mcp_dart

    A skill your agent uses when serving an MCP server over HTTP with mcpdart or connecting to a remote one: StreamableMcpServer setup, Host and Origin allowlists (DNS rebinding protection), CORS for…

    116 GitHub stars~2k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed

More from holon-run/uxc

All 62 skills in this repo

  • Context7 MCP Skill

    holon-run/uxc

    Query up-to-date library documentation and code examples using Context7 MCP.

    116 GitHub stars~564 tokensUpdated 26 days ago
    Auto-check passed

  • Deepwiki MCP Skill

    holon-run/uxc

    Ask questions and read documentation about any GitHub repository using DeepWiki MCP.

    116 GitHub stars~700 tokensUpdated 26 days ago
    Auto-check passed

  • Linear Graphql Skill

    holon-run/uxc

    Operate Linear workspace issues, projects, and teams through Linear GraphQL API using UXC.

    116 GitHub stars~1.8k tokensUpdated 26 days ago
    Auto-check passed

  • Notion Openapi Skill

    holon-run/uxc

    Operate Notion Public API through UXC with a curated OpenAPI schema for search, block traversal, page reads, content writes, and data source/database inspection.

    116 GitHub stars~2.3k tokensUpdated 26 days ago
    Auto-check passed

  • Alchemy Openapi Skill

    holon-run/uxc

    Operate Alchemy Prices API reads through UXC with a curated OpenAPI schema, path-templated API-key auth, and read-first guardrails.

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

  • Uxc

    holon-run/uxc

    Discover and call remote schema-exposed interfaces with UXC.

    116 GitHub stars~1.8k tokensUpdated 26 days ago
    Auto-check passed

Works with

Categories

Questions about Notion MCP Skill

What does Notion MCP Skill do?

Operate Notion workspace content through Notion MCP using the UXC CLI, including search, fetch, users/teams lookup, page/database creation and updates, and comments. Notion MCP Skill is an agent skill from holon-run/uxc. Operate Notion workspace content through Notion MCP using the UXC CLI, including search, fetch, users/teams lookup, page/database creation and updates, and comments.

When should I use Notion MCP Skill?

Notion MCP Skill fits situations like: tasks require calling Notion tools over MCP with OAuth (authorizationcode + PKCE); especially when safe write controls and JSON-envelope parsing are required.

How do I install Notion MCP Skill in Claude Code?

Run `npx skills add holon-run/uxc --skill notion-mcp-skill -a claude-code`. Or copy the skill folder (skills/notion-mcp-skill in holon-run/uxc) into .claude/skills/notion-mcp-skill in your project. Claude Code loads it when a task matches its description.

How do I install Notion MCP Skill in Codex?

Run `npx skills add holon-run/uxc --skill notion-mcp-skill -a codex`. Or copy the skill folder (skills/notion-mcp-skill in holon-run/uxc) into .agents/skills/notion-mcp-skill in your project. Codex loads it when a task matches its description.

Can I use Notion MCP Skill 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 holon-run/uxc --skill notion-mcp-skill -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-mcp-skill, .gemini/skills/notion-mcp-skill, .github/skills/notion-mcp-skill and .opencode/skills/notion-mcp-skill in your project.

What does Notion MCP Skill need to run?

Going by SKILL.md and its folder, Notion MCP Skill needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Notion MCP Skill access the network?

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

Is Notion MCP Skill 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Notion MCP Skill use?

Notion MCP Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion MCP Skill use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Notion MCP Skill?

Skills that share tags, products or a category with Notion MCP Skill: Flexport Enterprise Rbac (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Adding MCP Store Servers (PostHog/posthog, 40k stars), Xquik MCP (Xquik-dev/x-twitter-scraper, 211 stars) and Tenuo Agent Authorization (tenuo-ai/tenuo, 103 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion MCP Skill?

holon-run (a GitHub organization) maintains it in holon-run/uxc, which has 116 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 15, 2026.

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