Agent skill

Setup Notion

by ai-analyst-lab in ai-analyst-lab/ai-analyst

Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write.

MITAuto-check passedBackend & APIs

Install Setup Notion

skills CLI

$ npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a claude-code

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

GitHub CLI

$ gh skill install ai-analyst-lab/ai-analyst setup-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/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/setup-notion .claude/skills/setup-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/

Paste into Claude Code

Install the "setup-notion" agent skill from https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion into .claude/skills/setup-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-notion", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ai-analyst-lab/ai-analyst setup-notion --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/setup-notion .agents/skills/setup-notion && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "setup-notion" agent skill from https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion into .agents/skills/setup-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-notion", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ai-analyst-lab/ai-analyst setup-notion --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/setup-notion .cursor/skills/setup-notion && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "setup-notion" agent skill from https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion into .cursor/skills/setup-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-notion", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ai-analyst-lab/ai-analyst.git --path .claude/skills/setup-notion

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ai-analyst-lab/ai-analyst setup-notion --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/setup-notion .gemini/skills/setup-notion && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "setup-notion" agent skill from https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion into .gemini/skills/setup-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-notion", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ai-analyst-lab/ai-analyst setup-notion

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/setup-notion .github/skills/setup-notion && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "setup-notion" agent skill from https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion into .github/skills/setup-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-notion", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ai-analyst-lab/ai-analyst setup-notion --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/setup-notion .opencode/skills/setup-notion && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "setup-notion" agent skill from https://github.com/ai-analyst-lab/ai-analyst/tree/main/.claude/skills/setup-notion into .opencode/skills/setup-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "setup-notion", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: setup-notion
GitHub stars: 304
Token cost: ~883 tokens
SKILL.md length: 439 words
Files: 1
Skills in repo: 43
Repo updated: Sep 30, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write.

Works in 5 steps: Inspect before changing configuration → Add the official server → Authenticate → …
The user asks to connect Notion
SKILL.md covers Purpose, Current supported path, Instructions and Rules
Reaches mcp.notion.com

What it does

Setup Notion is an agent skill from ai-analyst-lab/ai-analyst. Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write. Use when the user asks to connect Notion, set up Notion, export to Notion, or diagnose an unavailable Notion connection.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering OAuth and OpenID Connect. It works with Notion and Model Context Protocol. The repository describes itself as: AI Product Analyst — Claude Code-powered data analysis toolkit. The licence is MIT.

When your agent uses it

The user asks to connect Notion
Export to Notion
Diagnose an unavailable Notion connection

Example prompts

“/setup-notion”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Inspect before changing configuration
Add the official server
Authenticate
Verify with a read
Report the result

What it can do on your machine

Read from SKILL.md and the folder at commit 52c0744. 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 json).
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

Setup Notion loads about 883 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 439 words of instructions outside code blocks.

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

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

The full file from ai-analyst-lab/ai-analyst at commit 52c0744, republished under its MIT licence (© ai-analyst-lab). 439 words, ~883 tokens.

Download SKILL.mdSave it as .claude/skills/setup-notion/SKILL.md (or your agent's skills folder).

name: setup-notion
description: Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write. Use when the user asks to connect Notion, set up Notion, export to Notion, or diagnose an unavailable Notion connection.

Setup Notion

Purpose

Configure Notion's official hosted MCP for this project, help the user complete browser OAuth, and verify the intended workspace before any content is created.

Current supported path

Official endpoint: https://mcp.notion.com/mcp
Transport: remote HTTP
Authentication: OAuth in the browser
Project configuration: .mcp.json

Notion's hosted MCP does not currently support file uploads. Do not promise that a local chart or other file can be uploaded through this server. Create the text page first. If the user needs an attachment, they can add it manually or use a separately approved API workflow.

Instructions

1. Inspect before changing configuration

Read .mcp.json if it exists.
Preserve every existing MCP server.
Check whether a Notion server already points to the official endpoint.
If Notion tools are already available, skip configuration and verify the connection.
Before editing anything, show the user the exact non-secret change and ask for approval.

Never replace the entire MCP configuration merely to add Notion.

2. Add the official server

After approval, add this project-local server entry while preserving the rest of .mcp.json:

json

{
  "notion": {
    "type": "http",
    "url": "https://mcp.notion.com/mcp"
  }
}

An equivalent supported Claude Code command is:

text

claude mcp add --transport http --scope project notion https://mcp.notion.com/mcp

Do not put tokens or credentials in the configuration.

3. Authenticate

If this session did not load the new server, tell the user to restart Claude Code. Then have the user run /mcp, select Notion, and complete OAuth in the browser.

Before the user authorizes access, remind them to confirm:

the Notion account;
the workspace;
whether that workspace is approved for the intended work; and
that the connected client can act with the access granted to that user.

Do not claim that OAuth proves the destination or makes every future action safe.

Show full SKILL.md (162 more words)Show less

4. Verify with a read

Ask the user for the title of a page they expect in the approved workspace. Use the available Notion search tool to find it without changing anything.

Show the workspace and matching page titles. If the expected page is missing, the workspace is wrong, or the tool call fails, stop and report the exact blocked step. Do not create a page.

5. Report the result

Report only what was verified:

text

Notion connection
Server: official hosted MCP
Endpoint: https://mcp.notion.com/mcp
Workspace: [verified workspace, if exposed]
Read test: [page title found, or exact blocked step]
Ready for an approved write: [yes or no]

Rules

Use only Notion's official hosted endpoint unless the user explicitly requests another server.
Preserve existing MCP servers.
Stop for approval before editing MCP configuration.
Never request or store a Notion API key for this OAuth path.
Verify the workspace with a read before any write.
Preview the destination and content before any later write.
Never claim that hosted Notion MCP can upload files.
If access is wrong, disconnect or revoke it rather than continuing with a nearby workspace.

Files

Just SKILL.md in .claude/skills/setup-notion of ai-analyst-lab/ai-analyst.

Open the folder on GitHubat commit 52c0744

Compare with similar skills

Setup 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.

Setup Notion compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Setup Notion this skillai-analyst-lab/ai-analyst	304	—	~883	Automated safety check: Pass	MIT	7 days ago
Notion MCP Skillholon-run/uxc	116	—	~1.2k	Automated safety check: Pass	MIT	23 days ago
Adding MCP Store ServersPostHog/posthog	40k	—	~1.6k	Automated safety check: Pass	Custom licence	today
Notion Worker Third-Party Auth Guidemakenotion/workers-template	439	1 repos	~3.5k	Automated safety check: Notes	MIT	27 days ago
Add OAuth Providersuperdesigndev/treg	4.8k	—	~2.5k	Automated safety check: Pass	Custom licence	today
Xquik MCPXquik-dev/x-twitter-scraper	209	1 repos	~997	Automated safety check: Pass	MIT	yesterday

Similar skills

Notion MCP Skill
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.
116 GitHub stars~1.2k tokensUpdated 23 days ago
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 today
Agent WorkflowsAuto-check passed
Notion Worker Third-Party Auth Guide
makenotion/workers-template
Official
Decides whether a Notion Worker should use a brokered credential, a plaintext environment secret, or OAuth to authenticate against a non-Notion service.
439 GitHub starsUsed in 1 repo~3.5k tokens
Backend & APIsAuto-check: notes
Add OAuth Provider
superdesigndev/treg
Add a provider to treg's OAuth registry (the ones treg holds its own approved app for).
4.8k GitHub stars~2.5k tokensUpdated today
Backend & APIsAuto-check passed
Xquik MCP
Xquik-dev/x-twitter-scraper
Connect, verify, and troubleshoot Xquik's remote MCP server.
209 GitHub starsUsed in 1 repo~997 tokens
Backend & APIsAuto-check passed
Entra Agent Id
microsoft/GitHub-Copilot-for-Azure
Official
Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…
255 GitHub starsUsed in 3 repos~4k tokens
Backend & APIsAuto-check passed

Questions about Setup Notion

What does Setup Notion do?

Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write. Setup Notion is an agent skill from ai-analyst-lab/ai-analyst. Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write.

When should I use Setup Notion?

Setup Notion fits situations like: the user asks to connect Notion; export to Notion; diagnose an unavailable Notion connection.

How do I install Setup Notion in Claude Code?

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

How do I install Setup Notion in Codex?

Run `npx skills add ai-analyst-lab/ai-analyst --skill setup-notion -a codex`. Or copy the skill folder (.claude/skills/setup-notion in ai-analyst-lab/ai-analyst) into .agents/skills/setup-notion in your project. Codex loads it when a task matches its description.

Can I use Setup 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 ai-analyst-lab/ai-analyst --skill setup-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/setup-notion, .gemini/skills/setup-notion, .github/skills/setup-notion and .opencode/skills/setup-notion in your project.

What does Setup Notion need to run?

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

Does Setup 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 Setup 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 Setup Notion use?

Setup Notion 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 Setup Notion use?

About 883 tokens (SKILL.md is roughly 3.5k 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 Setup Notion?

Skills that share tags, products or a category with Setup Notion: Notion MCP Skill (holon-run/uxc, 116 stars), Adding MCP Store Servers (PostHog/posthog, 40k stars), Notion Worker Third-Party Auth Guide (makenotion/workers-template, 439 stars) and Add OAuth Provider (superdesigndev/treg, 4.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Notion?

ai-analyst-lab (a GitHub organization) maintains it in ai-analyst-lab/ai-analyst, which has 304 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 30, 2026.

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

Install Setup Notion

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Setup Notion

Purpose

Current supported path

Instructions

1. Inspect before changing configuration

2. Add the official server

3. Authenticate

4. Verify with a read

5. Report the result

Rules

Files

Compare with similar skills

Similar skills

More from ai-analyst-lab/ai-analyst

Related

Questions about Setup Notion