Notion MCP Server

A Model Context Protocol (MCP) server for integrating with Notion workspaces

Catalog onlyCatalog onlySTDIO

Overview

Notion MCP is a Model Context Protocol (MCP) server designed to integrate with Notion workspaces, providing a standardized interface for AI models to access, query, and modify content in Notion.

To use Notion MCP, clone the repository, install dependencies, configure your Notion API key, build the project, and start the server. You can also integrate it with Claude for Desktop by configuring its settings.

Standardized interface for AI model integration with Notion - Access to databases, pages, and updates in Notion workspaces - Pre-configured prompts for common tasks

Querying tasks and deadlines in Notion workspaces.
Modifying content in Notion through AI commands.
Automating project status updates and summaries.

Add to your AI client

Use these steps to connect Notion MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "notion-mcp-ghubnerr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-ghubnerr"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

What are the prerequisites for using Notion MCP?

You need Node.js (v16 or higher) and a Notion API key.

Can I use Notion MCP with other applications?

Yes, it can be integrated with applications like Claude for Desktop.

Is there any support for extending the server?

Yes, you can add new resources, tools, and prompts by modifying the server code.

Developer tools