Skip to content
MCP server

MCP Neo4j Cypher

A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.0
Listing updated
4 days ago

About MCP Neo4j Cypher

MCP Neo4j Cypher is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-neo4j-cypher --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' -- uvx mcp-neo4j-cypher

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-neo4j-cypher": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<NEO4J_URI>",
        "NEO4J_USERNAME": "<NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<NEO4J_PASSWORD>"
      }
    }
  }
}

Configuration

  • NEO4J_URINeo4j connection URIRequired
  • NEO4J_USERNAMENeo4j usernameRequired
  • NEO4J_PASSWORDNeo4j passwordRequired
  • NEO4J_DATABASENeo4j database name
  • NEO4J_NAMESPACETool namespace prefix
  • NEO4J_RESPONSE_TOKEN_LIMITMaximum tokens for read query responses
  • NEO4J_READ_TIMEOUTTimeout in seconds for read queries
  • NEO4J_READ_ONLYAllow only read-only queries (true/false)
  • NEO4J_SCHEMA_SAMPLE_SIZESchema sample size

Pricing

Open source

MCP Neo4j Cypher FAQ

Is MCP Neo4j Cypher free?

Yes. MCP Neo4j Cypher is open source, so you can use and self-host it for free.

How do I add MCP Neo4j Cypher to Claude Code?

Run this command in your terminal: claude mcp add mcp-neo4j-cypher --env NEO4J_URI='<NEO4J_URI>' --env NEO4J_USERNAME='<NEO4J_USERNAME>' --env NEO4J_PASSWORD='<NEO4J_PASSWORD>' -- uvx mcp-neo4j-cypher