Record · notion-mcp-sMCP serverOpen sourceVerified Sep 23, 2026

Notion MCP Server

Notion's MCP server for searching, reading and editing a workspace; Notion now recommends its hosted version.

Sources and review

Checked against public documentation on September 23, 2026. Suitability guidance is our editorial judgment; this is not a performance benchmark or an endorsement.

Repository and README

Best for

Letting an assistant search, read and update Notion pages; choose the hosted Remote Notion MCP for new setups.

Avoid if

You want the self-hosted server in this repository; Notion no longer maintains or supports it.

About Notion MCP Server

Notion publishes this open-source, self-hosted MCP server, which exposes the Notion API to AI assistants and, since version 2.0, returns page content as Markdown. Notion's README now marks it as no longer actively maintained and directs users to Remote Notion MCP, its hosted server, which uses OAuth, respects each user's permissions and searches connected apps.

Notion MCP Server is an open-source project written primarily in TypeScript, with 4.6k stars on GitHub. It was last updated in September 2026.

Add Notion MCP Server to your MCP client

Generated from the launch command in the project's README. Your client starts the server on demand. Replace <your-integration-token> with your own value first.

Claude CodeRun in your terminal

claude mcp add notion-mcp-server -e 'NOTION_TOKEN=<your-integration-token>' -- npx -y @notionhq/notion-mcp-server

Cursor~/.cursor/mcp.json or .cursor/mcp.json

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "<your-integration-token>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "notion-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "<your-integration-token>"
      }
    }
  }
}

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "<your-integration-token>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.notion-mcp-server]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
env = { NOTION_TOKEN = "<your-integration-token>" }

Check the project's README for required accounts, keys and permissions before connecting. Setup guide for each client →

For agent buildersMake your product part of the discovery.Explore advertising

Notion MCP Server vs. the alternatives

All 163 alternatives →

Record	Stars	Language	License	Pricing
Notion MCP ServerMCP serverthis listing	4.6k	TypeScript	MIT	Open source
MCP Reference ServersMCP server	91k	TypeScript	MIT AND Apache-2.0	Open source
context7MCP server	62k	TypeScript	MIT	Open source
chrome-devtools-mcpMCP server	53k	TypeScript	Apache-2.0	Open source
Playwright MCPMCP server	37k	TypeScript	Apache-2.0	Open source
github-mcp-serverMCP server	33k	Go	MIT	Open source

See all 163 Notion MCP Server alternatives, compared →