drio
Open app

Neo4j MCP Server for Cursor

Source

A Cursor MCP (Model Context Protocol) server that enables seamless interaction with Neo4j databases directly from the Cursor IDE.

Catalog onlyCatalog onlySTDIO

Overview

Neo4j MCP Server for Cursor is a Model Context Protocol (MCP) server that facilitates seamless interaction with Neo4j databases directly from the Cursor IDE.

To use the Neo4j MCP Server, clone the repository, install dependencies, configure environment variables, and start the server using the Cursor IDE or manually via command line.

  • Connect to Neo4j databases and execute Cypher queries. - Transform Neo4j-specific data types to standard JavaScript objects. - Use the official MCP SDK for integration with Cursor. - Support for environment variables for secure credential management. - Retrieve detailed database information and metrics. - Monitor connection status and diagnostics.
  1. Executing complex queries against Neo4j databases.
  2. Integrating Neo4j database operations within the Cursor IDE.
  3. Monitoring and managing Neo4j database connections and performance.

Add to your AI client

Use these steps to connect Neo4j MCP Server for Cursor 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": {
    "neo4j-mcp-ezedinff": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-neo4j-mcp-ezedinff"
      ]
    }
  }
}

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

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

**What are the prerequisites for using Neo4j MCP Server?**

You need Bun (v1.0.0 or higher) and a Neo4j database (local or remote).

**How do I run Neo4j with Docker Compose?**

Use the provided Docker Compose configuration to start Neo4j easily.

**Can I use environment variables for credentials?**

Yes, you can configure your Neo4j credentials using environment variables in a `.env` file.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2928,"uuid":"2a292035-ac4b-43fb-a9cc-f0368ebba723","name":"neo4j-mcp","title":"Neo4j MCP Server for Cursor","description":"A Cursor MCP (Model Context Protocol) server that enables seamless interaction with Neo4j databases directly from the Cursor IDE.","avatar_url":"https://avatars.githubusercontent.com/u/19648503?v=4","created_at":"2025-03-16T04:16:27.765Z","updated_at":"2025-03-16T05:00:13.179Z","status":"created","author_name":"ezedinff","author_avatar_url":"https://avatars.githubusercontent.com/u/19648503?v=4","tags":"ai,mcp,cursor","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/ezedinff/neo4j-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-16 00:10:38\"}","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