mcpField
N
Neo4j MCP Server

Neo4j MCP Server

Local
github.com/Tobarrientos2Databases4Updated 89w ago
Repository

About Neo4j MCP Server

Neo4j MCP Server connects MCP clients to a Neo4j graph database and lets them run Cypher queries. It is configured with Neo4j connection credentials and is compatible with Cursor and Claude Desktop.

Key features

  1. 01Run Cypher queries against Neo4j
  2. 02Configure connection with environment variables
  3. 03Load settings from a .env file
  4. 04Use with Cursor and Claude Desktop

Use cases

  1. 01Query graph data from an MCP client
  2. 02Inspect nodes with Cypher queries

MCP support

Exposes a `neo4j-query` tool to MCP clients for executing Cypher queries against a Neo4j database.

#neo4j#graph-database#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "neo4j-mcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "neo4j-mcpserver"
      ],
      "env": {
        "NEO4J_CONNECTION": "<NEO4J_CONNECTION>"
      }
    }
  }
}
Run commandnpx -y neo4j-mcpserver
Environment variables to set
NEO4J_CONNECTION

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmneo4j-mcpserver

Tools

4

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
pulseobjectYes
pulse.namestringYes
pulse.versionstringNo
pulse.descriptionstringNo
pulse.isAsyncbooleanNo
pulse.isMainPulsebooleanNo
pulse.fileLocationstringYes
entitystringYes
actionstringYes
dataStructuresobjectNo
dataStructures.inputsarrayNo
dataStructures.outputsarrayNo
relationshipsarrayNo

Details

From the project README

Neo4j MCP Server

A Neo4j MCP server implementation for managing graph database operations through the Model Context Protocol.

🔌 Compatible with both Cursor and Claude Desktop!

Quick Start

You can run the server directly using npx:

# Using a single connection string
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# Or using separate environment variables
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io NEO4J_USER=neo4j NEO4J_PASSWORD=your-password npx neo4j-mcpserver

Installation

If you prefer to install the package globally:

npm install -g neo4j-mcpserver

Then run it:

NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password neo4j-mcpserver

Environment Variables

You can provide the Neo4j connection details in two ways:

  1. Using a single connection string:

    NEO4J_CONNECTION=<uri>,<user>,<password>

  2. Using separate environment variables:

    NEO4J_URI=<your-uri>
NEO4J_USER=<your-user>
NEO4J_PASSWORD=<your-password>

You can also use a .env file in your project root:

NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password

Configuration ⚙️

Configuring Cursor 🖥️

To set up the Neo4j MCP server in Cursor:

  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click on the "+ Add New MCP Server" button
  4. Fill out the following information:
    • Name: Enter a nickname for the server (e.g., "neo4j-mcp")
    • Type: Select "command" as the type
    • Command: Enter the command to run the server:
    env=NEO4J_URI=your-neo4j-uri,NEO4J_USER=your-neo4j-user,NEO4J_PASSWORD=your-neo4j-password npx -y @neobarrientos/neo4j_mcpserver
    Important: Replace the credentials with your actual Neo4j database credentials.

Available Tools 🛠️

neo4j-query

Execute Cypher queries against your Neo4j database.

Example usage in Cursor:

MATCH (n) RETURN n LIMIT 5

Troubleshooting 🔧

If you encounter issues:

  1. Verify Neo4j Credentials

    • Check that your Neo4j URI, username, and password are correct
    • Ensure your Neo4j database is accessible

  2. Path Issues

    • Ensure there are no spaces in the installation path
    • Use forward slashes (/) in paths

  3. Tool Detection Issues

    • Try restarting Cursor
    • Verify the server is running (check Cursor's MCP server list)
    • Check that environment variables are properly set

Development 👩‍💻

To run locally:

git clone <repository-url>
cd neo4j-mcpserver
npm install
npm run build
npm start

License

ISC

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.