What is notion-mcp-server?
notion-mcp-server is a MCP server by awkoy that context-efficient Notion access: pages, databases, blocks, comments, files and templates through a minimal tool set, with token auth for headless use. It is listed under Other and has 177 GitHub stars.
| Type | Mcp server |
|---|---|
| Author | awkoy |
| Repository | awkoy/notion-mcp-server |
| Popularity | 177 GitHub stars |
| Category | Other |
| Security | Low risk (92/100) |
| Rank | #445 of 4,418 MCP servers; #62 in Other |
| License | MIT |
| Last commit | 2026-10-17 |
| Stars this week | +3 |
| Runs | Locally |
| Language | TypeScript |
| Platforms | macOS, Windows, Linux |
Is notion-mcp-server safe to install?
notion-mcp-server scores 92/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 4 of 6 checks.
MCP server results come from listing signals: who publishes it, where your data goes and what it can do. The code itself is not scanned yet.
| Check | Result |
|---|---|
| Community-built server | Note |
| Runs on your machine only | Pass |
| Needs an API key or account login | Note |
| Read-only by description | Pass |
| No code execution | Pass |
| Source on GitHub | Pass |
How do I install notion-mcp-server?
- Find the launch command. The README says how the server starts (npx, uvx, docker or a remote URL) and which API keys it needs.
https://github.com/awkoy/notion-mcp-server
- Add it to Claude Code. Replace the part after -- with the command from the README. Remote servers use --transport http with a URL.
claude mcp add notion-mcp-server -- <command from README> claude mcp add --transport http notion-mcp-server <server-url>
- Check it connected. This lists your MCP servers and their status.
claude mcp list
Or ask Claude to set it up
Paste this into Claude Code and it installs notion-mcp-server for you:
Add the "notion-mcp-server" MCP server from https://github.com/awkoy/notion-mcp-server to Claude Code. Read its README for the launch command and any API keys I need, run claude mcp add, then check that it connects.