mcpbeat Sign in

Notion MCP Server

local only

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.

Installs per day peak 1 142 · avg 489 · +94% w/w
a month agotoday
4 674
Installs / week
npm · notion-mcp-server
179
Stars
0 open issues
26 Oct 2026
Last commit
8 releases in 90 days
MIT
License
TypeScript

Nothing serious here today

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.

Three servers free · no card

Connect this server

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.

run in your terminal
claude mcp add notion-mcp-server -e 'NOTION_TOKEN=<NOTION_TOKEN>' -- npx -y notion-mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "<NOTION_TOKEN>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.notion-mcp-server]
command = "npx"
args = ["-y", "notion-mcp-server"]
env = { NOTION_TOKEN = "<NOTION_TOKEN>" }
.cursor/mcp.json
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "<NOTION_TOKEN>"
      }
    }
  }
}
.vscode/mcp.json
{
  "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).

Alternatives to Notion MCP Server

same job, measured the same way
Taskavel
by taskavel

Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.

answering
headlesson
by headlesson

Find and compare headless apps (CLI, MCP, API) for agents, with sources, lessons and changes.

4 tools answering
Magic Cloud
by polterguy

Generate secured CRUD APIs over your database, run SQL, manage files, tasks and a headless browser

local only
H
headlesshunt
by headlesshunt

Launch board run by AI agents: find tools by what they do, launch products, vote, comment, discuss.

14 tools answering
Crystallize MCP
by hayodev

Crystallize headless commerce tools for AI agents via Model Context Protocol

104 installs/wk local only
pdfrender
by pdfrender

HTML and CSS to PDF MCP server with page headers, footers and page numbers. No headless browser.

1 tools answering
unbrowser by Unchained
by protostatis

Chrome-free MCP web access for agents with low-token page maps and browser escalation hints.

129 installs/wk local only
DLBrowser
by dekryptlabs

Self-healing web access for AI agents — recovers through bot blocks, captchas and JS pages.

54 installs/wk local only

Notion MCP Server — questions

Answers built from our own checks of this server.

Why is there no uptime for Notion MCP Server?
Notion MCP Server runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package notion-mcp-server was installed 4 674 times last week.
How do I connect Notion MCP Server?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls notion-mcp-server straight from npm; nothing to host, nothing to sign up for.
How many people use Notion MCP Server?
The npm package notion-mcp-server was installed 4 674 times in the last week. Week over week that is +94%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Notion MCP Server open source?
Yes — it is published under the MIT licence, written in TypeScript and 179 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.