PluginBench
MCP Server

io.github.neo4j-contrib/mcp-neo4j-cypher MCP Server

io.github.neo4j-contrib/mcp-neo4j-cypher

RepositoryRegistry

What is the io.github.neo4j-contrib/mcp-neo4j-cypher MCP server?

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

How to install io.github.neo4j-contrib/mcp-neo4j-cypher

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • NEO4J_URI
    required

    Neo4j connection URI

  • NEO4J_USERNAME
    required

    Neo4j username

  • NEO4J_PASSWORD
    required
    secret

    Neo4j password

  • NEO4J_DATABASE

    Neo4j database name

  • NEO4J_NAMESPACE

    Tool namespace prefix

  • NEO4J_RESPONSE_TOKEN_LIMIT

    Maximum tokens for read query responses

  • NEO4J_READ_TIMEOUT

    Timeout in seconds for read queries

  • NEO4J_READ_ONLY

    Allow only read-only queries (true/false)

  • NEO4J_SCHEMA_SAMPLE_SIZE

    Schema sample size

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<YOUR_NEO4J_URI>",
        "NEO4J_USERNAME": "<YOUR_NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<YOUR_NEO4J_PASSWORD>",
        "NEO4J_DATABASE": "<YOUR_NEO4J_DATABASE>",
        "NEO4J_NAMESPACE": "<YOUR_NEO4J_NAMESPACE>",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "<YOUR_NEO4J_RESPONSE_TOKEN_LIMIT>",
        "NEO4J_READ_TIMEOUT": "<YOUR_NEO4J_READ_TIMEOUT>",
        "NEO4J_READ_ONLY": "<YOUR_NEO4J_READ_ONLY>",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "<YOUR_NEO4J_SCHEMA_SAMPLE_SIZE>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<YOUR_NEO4J_URI>",
        "NEO4J_USERNAME": "<YOUR_NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<YOUR_NEO4J_PASSWORD>",
        "NEO4J_DATABASE": "<YOUR_NEO4J_DATABASE>",
        "NEO4J_NAMESPACE": "<YOUR_NEO4J_NAMESPACE>",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "<YOUR_NEO4J_RESPONSE_TOKEN_LIMIT>",
        "NEO4J_READ_TIMEOUT": "<YOUR_NEO4J_READ_TIMEOUT>",
        "NEO4J_READ_ONLY": "<YOUR_NEO4J_READ_ONLY>",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "<YOUR_NEO4J_SCHEMA_SAMPLE_SIZE>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<YOUR_NEO4J_URI>",
        "NEO4J_USERNAME": "<YOUR_NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<YOUR_NEO4J_PASSWORD>",
        "NEO4J_DATABASE": "<YOUR_NEO4J_DATABASE>",
        "NEO4J_NAMESPACE": "<YOUR_NEO4J_NAMESPACE>",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "<YOUR_NEO4J_RESPONSE_TOKEN_LIMIT>",
        "NEO4J_READ_TIMEOUT": "<YOUR_NEO4J_READ_TIMEOUT>",
        "NEO4J_READ_ONLY": "<YOUR_NEO4J_READ_ONLY>",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "<YOUR_NEO4J_SCHEMA_SAMPLE_SIZE>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "mcp-neo4j-cypher": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "<YOUR_NEO4J_URI>",
        "NEO4J_USERNAME": "<YOUR_NEO4J_USERNAME>",
        "NEO4J_PASSWORD": "<YOUR_NEO4J_PASSWORD>",
        "NEO4J_DATABASE": "<YOUR_NEO4J_DATABASE>",
        "NEO4J_NAMESPACE": "<YOUR_NEO4J_NAMESPACE>",
        "NEO4J_RESPONSE_TOKEN_LIMIT": "<YOUR_NEO4J_RESPONSE_TOKEN_LIMIT>",
        "NEO4J_READ_TIMEOUT": "<YOUR_NEO4J_READ_TIMEOUT>",
        "NEO4J_READ_ONLY": "<YOUR_NEO4J_READ_ONLY>",
        "NEO4J_SCHEMA_SAMPLE_SIZE": "<YOUR_NEO4J_SCHEMA_SAMPLE_SIZE>"
      }
    }
  }
}
Claude Code
claude mcp add mcp-neo4j-cypher --env NEO4J_URI=<YOUR_NEO4J_URI> --env NEO4J_USERNAME=<YOUR_NEO4J_USERNAME> --env NEO4J_PASSWORD=<YOUR_NEO4J_PASSWORD> --env NEO4J_DATABASE=<YOUR_NEO4J_DATABASE> --env NEO4J_NAMESPACE=<YOUR_NEO4J_NAMESPACE> --env NEO4J_RESPONSE_TOKEN_LIMIT=<YOUR_NEO4J_RESPONSE_TOKEN_LIMIT> --env NEO4J_READ_TIMEOUT=<YOUR_NEO4J_READ_TIMEOUT> --env NEO4J_READ_ONLY=<YOUR_NEO4J_READ_ONLY> --env NEO4J_SCHEMA_SAMPLE_SIZE=<YOUR_NEO4J_SCHEMA_SAMPLE_SIZE> -- uvx mcp-neo4j-cypher

Related MCP servers

io.github.neo4j-contrib/mcp-neo4j-aura-manager

MCP server for Neo4j Aura Database Instance Manager.

View repository →

io.github.neo4j-contrib/mcp-neo4j-data-modeling

A simple Neo4j MCP server for creating graph data models.

View repository →

io.github.neo4j-contrib/mcp-neo4j-memory

MCP Neo4j Knowledge Graph Memory Server

View repository →
io.github.neo4j-contrib/mcp-neo4j-cypher MCP Server | PluginBench