F
felixhorobot/Notion-Desktop-MCP
An MCP server that lets AI agents control the Notion Desktop app on your computer.
★ 1·updated 2026-10-31
View on GitHub ↗Direct link · no redirect page
We have no copy-paste install command and no public remote endpoint, so we do not print a config. The step above is reference only, not a command we can vouch for. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 1 ★ · felixhorobot/Notion-Desktop-MCP · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 1 ★ · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
felixhorobot/Notion-Desktop-MCP;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# Notion-Desktop-MCP
Excerpted from the repository README (abridged)
An MCP server that lets AI agents control the Notion Desktop app on your computer. It ships as a
Claude Code plugin and works with any other MCP client (Cursor, VS Code, Codex CLI, Gemini CLI and
others). It connects through Notion's debug mode. Notion starts with a remote debugging port
(localhost:9222), and the server drives the app over that port, the way browser automation tools
drive Chrome.
> ⚠️ Use at your own risk. An AI agent edits your real Notion content, and the debug port is open
> to local programs while it runs. Read Disclaimer and risks before you install.
## Why use it instead of the official Notion connector
| | Official Notion MCP / API | Notion-Desktop-MCP |
| Sign-in | OAuth or an integration token | None. Uses the Notion Desktop app you are already logged in to |
| Workspace admin | An owner or admin often has to approve or install the integration | No admin step. Nothing is installed in the workspace |
| Page access | Pages must be shared with the integration | Every page you can open in the app |
| Guest workspaces | Usually not reachable (guests cannot add integrations) | ✅ Works wherever you are a guest with edit access |
| Runs where | Notion's servers / API | Your own computer, against your local Notion Desktop |
In short: if Notion Desktop is logged in on your PC, the agent can work in it. It does not work with
Notion in a web browser.
Not needing approval is a technical fact, not permission. Your organisation's rules on automation and
AI tools still apply; see Disclaimer and risks.
Real recording. One notion_insert call writes a 12-block section (headings, numbered list, to-dos,
code). One notion_create_database call then builds a 6-row database. The calls took about 5 s and
11 s.
## How it works
AI agent ──MCP──▶ notion-desktop-mcp server ──CDP──▶ Notion Desktop in debug mode (localhost:9222)
1. notion_launch restarts Notion Desktop with --remote-debugging-port=9222. Notion saves
continuously, so the restart loses nothing.
2. The MCP server connects to that port with Playwright and exposes Notion-specific tools.
3. On connect, the server sends every client short usage and safety instructions. Claude Code also
loads the full skill (skills/notion-desktop-mcp/SKILL.md).
Without debug mode the tools cannot connect. Switching Notion back to normal mode closes the port.
## Install
All installs need Node.js 18 or newer and the Notion Desktop app. Pick the
section for your agent.
### Claude Code
bash
claude plugin marketplace add felixhorobot/Notion-Desktop-MCP && claude plugin install notion-desktop-mcp@notion-desktop-mcp
The same two steps from inside Claude Code:
/plugin marketplace add felixhorobot/Notion-Desktop-MCP
/plugin install notion-desktop-mcp@notion-desktop-mcp
Restart Claude Code and ask it to "start Notion in debug mode". Claude calls notion_launch. The
first start also installs the server's npm packages, which takes about 30 s.
Install from a clone, with desktop shortcuts (Windows)
powershell
git clone https://github.com/felixhorobot/Notion-Desktop-MCP
cd Notion-Desktop-MCP
powershell -ExecutionPolicy Bypass -File install.ps1
The script installs the dependencies, registers the MCP server, links the skill into
Claude Code plugin and works with any other MCP client (Cursor, VS Code, Codex CLI, Gemini CLI and
others). It connects through Notion's debug mode. Notion starts with a remote debugging port
(localhost:9222), and the server drives the app over that port, the way browser automation tools
drive Chrome.
> ⚠️ Use at your own risk. An AI agent edits your real Notion content, and the debug port is open
> to local programs while it runs. Read Disclaimer and risks before you install.
## Why use it instead of the official Notion connector
| | Official Notion MCP / API | Notion-Desktop-MCP |
| Sign-in | OAuth or an integration token | None. Uses the Notion Desktop app you are already logged in to |
| Workspace admin | An owner or admin often has to approve or install the integration | No admin step. Nothing is installed in the workspace |
| Page access | Pages must be shared with the integration | Every page you can open in the app |
| Guest workspaces | Usually not reachable (guests cannot add integrations) | ✅ Works wherever you are a guest with edit access |
| Runs where | Notion's servers / API | Your own computer, against your local Notion Desktop |
In short: if Notion Desktop is logged in on your PC, the agent can work in it. It does not work with
Notion in a web browser.
Not needing approval is a technical fact, not permission. Your organisation's rules on automation and
AI tools still apply; see Disclaimer and risks.
Real recording. One notion_insert call writes a 12-block section (headings, numbered list, to-dos,
code). One notion_create_database call then builds a 6-row database. The calls took about 5 s and
11 s.
## How it works
AI agent ──MCP──▶ notion-desktop-mcp server ──CDP──▶ Notion Desktop in debug mode (localhost:9222)
1. notion_launch restarts Notion Desktop with --remote-debugging-port=9222. Notion saves
continuously, so the restart loses nothing.
2. The MCP server connects to that port with Playwright and exposes Notion-specific tools.
3. On connect, the server sends every client short usage and safety instructions. Claude Code also
loads the full skill (skills/notion-desktop-mcp/SKILL.md).
Without debug mode the tools cannot connect. Switching Notion back to normal mode closes the port.
## Install
All installs need Node.js 18 or newer and the Notion Desktop app. Pick the
section for your agent.
### Claude Code
bash
claude plugin marketplace add felixhorobot/Notion-Desktop-MCP && claude plugin install notion-desktop-mcp@notion-desktop-mcp
The same two steps from inside Claude Code:
/plugin marketplace add felixhorobot/Notion-Desktop-MCP
/plugin install notion-desktop-mcp@notion-desktop-mcp
Restart Claude Code and ask it to "start Notion in debug mode". Claude calls notion_launch. The
first start also installs the server's npm packages, which takes about 30 s.
Install from a clone, with desktop shortcuts (Windows)
powershell
git clone https://github.com/felixhorobot/Notion-Desktop-MCP
cd Notion-Desktop-MCP
powershell -ExecutionPolicy Bypass -File install.ps1
The script installs the dependencies, registers the MCP server, links the skill into
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/felixhorobot-notion-desktop-mcp/)
- Source
- awesome · https://github.com/felixhorobot/Notion-Desktop-MCP
- Browse by field
- MCP servers
- Traction
- 1 ★
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.