notion-mcp-server
Rank #1,412io.github.awkoy/notion-mcp-server
Token-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
notion-mcp-server is a Model Context Protocol (MCP) server published by awkoy. It ranks #1,412 of 115,460 servers tracked on MCP Toplist, and its repository has 168 GitHub stars. notion-mcp-server is listed across 4 registries — Official MCP, Glama, PulseMCP and mcp.so, with 2 tracked versions. It was first listed on Mar 19, 2025 and most recently updated on Aug 2, 2026.
Ranks ahead of 114,048 of 115,460 servers on MCP Toplist.
Use notion-mcp-server
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add notion-mcp-server -e "NOTION_TOKEN=<your NOTION_TOKEN>" -e "NOTION_PAGE_ID=<your NOTION_PAGE_ID>" -- npx -y notion-mcp-serverReplace each placeholder with your own value before saving.
[mcp_servers.notion-mcp-server]
command = "npx"
args = ["-y", "notion-mcp-server"]
[mcp_servers.notion-mcp-server.env]
NOTION_TOKEN = "<your NOTION_TOKEN>"
NOTION_PAGE_ID = "<your NOTION_PAGE_ID>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>",
"NOTION_PAGE_ID": "<your NOTION_PAGE_ID>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>",
"NOTION_PAGE_ID": "<your NOTION_PAGE_ID>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"notion-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>",
"NOTION_PAGE_ID": "<your NOTION_PAGE_ID>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>",
"NOTION_PAGE_ID": "<your NOTION_PAGE_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>",
"NOTION_PAGE_ID": "<your NOTION_PAGE_ID>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.awkoy%2Fnotion-mcp-server)<a href="https://mcptoplist.com/server/io.github.awkoy%2Fnotion-mcp-server"><img src="https://mcptoplist.com/badge/io.github.awkoy%2Fnotion-mcp-server.svg" alt="MCP Toplist: Top 5% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries (2 delisted)
awkoy
Other servers by awkoy
View all awkoy servers →Available versions (2)
| Version | Published |
|---|---|
| 2.13.0 | Aug 2, 2026 |
| 2.10.1 | Jul 3, 2026 |
Frequently asked questions
- Who maintains notion-mcp-server?
- notion-mcp-server is maintained by awkoy, which publishes 2 MCP servers (5 total versions) tracked on MCP Toplist.
- Is notion-mcp-server listed on the Official MCP Registry?
- Yes — notion-mcp-server is listed on the Official MCP Registry, alongside Glama, PulseMCP and mcp.so.
- How many versions does notion-mcp-server have?
- MCP Toplist tracks 2 versions of notion-mcp-server, most recently published on Aug 2, 2026.
- Where can I find the source code for notion-mcp-server?
- The source code for notion-mcp-server is hosted at github.com/awkoy/notion-mcp-server.