drio
Open app

Notion MCP Server

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

Notion MCP Server is a tool that enables Claude to interact with Notion workspaces by utilizing the Notion API.

To use Notion MCP Server, you'll need to create a Notion integration, retrieve the secret key, and configure Claude Desktop with the integration token in the claude_desktop_config.json file.

  • Seamless integration with Notion using Claude. - Supports various Notion API operations like retrieving blocks, updating pages, and creating databases. - Allows for extensive manipulation of Notion content, including comments and user management.
  1. Automating data entry and updates within Notion databases.
  2. Integrating Notion with other applications to enhance productivity.
  3. Managing user comments and interactions within Notion pages.

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": {
    "suekou-mcp-notion-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-suekou-mcp-notion-server-mcp-mirror"
      ]
    }
  }
}

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": {
    "suekou-mcp-notion-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-suekou-mcp-notion-server-mcp-mirror"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

What permissions do I need for the Notion integration?

You need to select the appropriate permissions such as "Read content" and "Update content" during integration creation.

What should I do if I encounter permission errors?

Ensure that the integration has the required permissions and is invited to the relevant pages or databases.

Is there any documentation available for setup?

Yes, detailed setup instructions are provided in both English and Japanese on the project repository.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":579,"uuid":"0c72e68d-7442-45db-a2c5-0e835ec9aefa","name":"suekou_mcp-notion-server","title":"Notion MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:22:55.843Z","updated_at":"2025-01-05T03:00:19.508Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"notion,mcp-server,api-integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/suekou_mcp-notion-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Notion MCP Server — MCP Registry