Notion MCP Server

Install Notion MCP Server

Paste this into your MCP client config — Claude Desktop, Claude Code, Cursor, VS Code and Windsurf all read the same shape — then restart the client.

npx -y @notionhq/notion-mcp-server

Config for each MCP client

The same server, in the shape each client expects. Copy the block for yours, restart it, and Notion MCP Server appears in your next session.

Claude Desktop

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Full Claude Desktop setup guide

Claude Code

claude mcp add notion -- npx -y @notionhq/notion-mcp-server

Full Claude Code setup guide

Cursor

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Full Cursor setup guide

VS Code

{
  "servers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Full VS Code setup guide

Windsurf

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Full Windsurf setup guide

Details

Repository

https://github.com/makenotion/notion-mcp-server

Homepage

https://github.com/makenotion/notion-mcp-server

Category

Productivity

Stars

6200

Installs per month

61000

Last checked

2026-07-17

Frequently asked questions

How do I install Notion MCP Server?

Add it to your MCP client's config with the command `npx -y @notionhq/notion-mcp-server`, or paste the ready-made JSON block above into Claude Desktop, Cursor, VS Code or Windsurf. Claude Code users can run `claude mcp add notion` instead. Restart the client and the tools appear in the next session.

Does Notion MCP Server need an API key?

No credential is recorded for this listing, which usually means it runs against something local or public rather than an authenticated API. Check the repository's README before assuming, and if you find otherwise, tell us and we will correct the listing.

Which clients work with Notion MCP Server?

Any MCP client. Claude Desktop, Claude Code, Cursor, VS Code with Copilot, Windsurf, Zed, Cline and Continue all speak the Model Context Protocol, so a server written once works in all of them — only the location of the config file differs.

Is Notion MCP Server free?

The server itself is free and open source, and you run it yourself. It is published by the vendor of the system it connects to, so that service's own pricing applies to whatever it reaches.

Other Productivity servers

• Linear MCP Server — Issues, cycles and projects over MCP. Official (Productivity)
• Obsidian MCP Server — Read and search a local vault. (Productivity)