notion-mcp-server

local MCP server

Installation

Terminal

claude mcp add notion-mcp-server -e NOTION_TOKEN=... -e NOTION_PAGE_ID=... -- npx -y notion-mcp-server

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "...",
        "NOTION_PAGE_ID": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

Token-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.

Questions

notion-mcp-server is a local MCP server distributed as the npm package notion-mcp-server.

Run: claude mcp add notion-mcp-server -e NOTION_TOKEN=... -e NOTION_PAGE_ID=... -- npx -y notion-mcp-server

Run: codex mcp add notion-mcp-server --env NOTION_TOKEN=... --env NOTION_PAGE_ID=... -- npx -y notion-mcp-server

Similar MCP servers

NameStars

remnusio.github.Ranork/remnus73
Artifact Sharecom.artifactshare/artifactshare33
Repomixio.github.yamadashy/repomix29K
dbxio.github.t8y2/dbx21K
jCodemunch MCPio.github.jgravelle/jcodemunch-mcp2,716
Magic Cloudio.github.polterguy/magic1,197
ref-tools-mcpio.github.ref-tools/ref-tools-mcp1,176
ref-tools-mcptools.ref/ref-tools-mcp1,176