Notion MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 4 674 installs a week from npm. Last commit 26 Oct 2026.
Token-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
Today is the operative word: we check Notion MCP Server every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add notion-mcp-server -e 'NOTION_TOKEN=<NOTION_TOKEN>' -- npx -y notion-mcp-server
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}
[mcp_servers.notion-mcp-server]
command = "npx"
args = ["-y", "notion-mcp-server"]
env = { NOTION_TOKEN = "<NOTION_TOKEN>" }
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}
{
"servers": {
"notion-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}
Put your own value in place of
<NOTION_TOKEN> (Notion Personal Access Token (ntn_...) or Internal Integration Secret. Create at https://app.notion.com/developers/tokens).
The author’s registry entry marks it as required.
Optional settings from the registry entry, left out of the block above:
NOTION_PAGE_ID (Optional default parent page ID used by create_page / create_database when no parent is passed).
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Find and compare headless apps (CLI, MCP, API) for agents, with sources, lessons and changes.
Generate secured CRUD APIs over your database, run SQL, manage files, tasks and a headless browser
Launch board run by AI agents: find tools by what they do, launch products, vote, comment, discuss.
Crystallize headless commerce tools for AI agents via Model Context Protocol
HTML and CSS to PDF MCP server with page headers, footers and page numbers. No headless browser.
Chrome-free MCP web access for agents with low-token page maps and browser escalation hints.
Self-healing web access for AI agents — recovers through bot blocks, captchas and JS pages.
Answers built from our own checks of this server.