drio
Open app

Notion MCP Server

Source

Catalog onlyCatalog onlySTDIO

Overview

Notion MCP Server is a Model Context Protocol server designed for integrating Claude and other LLMs with your Notion workspace, enabling seamless interaction and management of Notion content.

To use the Notion MCP Server, clone the repository, install dependencies, configure your Notion API key, build the server, and run it. Connect it with Claude for Desktop to start using it.

  • Search across your entire Notion workspace - Retrieve content from specific Notion pages - Create and update pages in your Notion workspace - Create and query databases with custom properties - Update database entries and add new rows to existing databases
  1. Searching for specific notes or documents in Notion.
  2. Creating new project pages or task lists directly from Claude.
  3. Updating existing content in Notion without manual input.
  4. Managing databases for project tracking and organization.

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

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

Claude Code

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

.mcp.json (project root)

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

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

Can I use Notion MCP Server with any LLM?

Yes! It is designed to work with Claude and other LLMs that support the Model Context Protocol.

Is there a cost to use Notion MCP Server?

No, it is free to use as it is an open-source project.

What programming language is Notion MCP Server written in?

The server is written in TypeScript.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1803,"uuid":"1e0ff9a5-2af8-4279-a5ab-30d9f870f4c5","name":"notion-mcp-server","title":"Notion MCP Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/131299790?v=4","created_at":"2025-03-05T05:26:50.624Z","updated_at":"2025-03-12T10:20:52.937Z","status":"created","author_name":"SAhmadUmass","author_avatar_url":"https://avatars.githubusercontent.com/u/131299790?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/SAhmadUmass/notion-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-06 14:52:56\"}","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"}]]}]

Developer tools