Neo4j Cypher

by Neo4j

v0.6.0

Repository Docs

Databases & Data

graph-databaseneo4jcypherknowledge-graph

Summary

Query Neo4j graph databases in natural language — the assistant reads your schema and writes the Cypher.

Features

Run read and write Cypher queries against Neo4j
Retrieve the graph schema for accurate query generation
Works with Neo4j Aura and self-managed instances

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Neo4j Cypher" tools will be available.

{
  "mcpServers": {
    "neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add neo4j-cypher -e NEO4J_URI=bolt://localhost:7687 -e NEO4J_USERNAME=neo4j -e NEO4J_PASSWORD=password -- uvx mcp-neo4j-cypher

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "neo4j-cypher": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "password"
      }
    }
  }
}

Cursor

{
  "command": "uvx",
  "args": [
    "mcp-neo4j-cypher"
  ],
  "env": {
    "NEO4J_URI": "bolt://localhost:7687",
    "NEO4J_USERNAME": "neo4j",
    "NEO4J_PASSWORD": "password"
  }
}

Windsurf

{
  "command": "uvx",
  "args": [
    "mcp-neo4j-cypher"
  ],
  "env": {
    "NEO4J_URI": "bolt://localhost:7687",
    "NEO4J_USERNAME": "neo4j",
    "NEO4J_PASSWORD": "password"
  }
}

VS Code

{
  "command": "uvx",
  "args": [
    "mcp-neo4j-cypher"
  ],
  "env": {
    "NEO4J_URI": "bolt://localhost:7687",
    "NEO4J_USERNAME": "neo4j",
    "NEO4J_PASSWORD": "password"
  }
}

Description

The Neo4j Cypher MCP server lets an assistant query a graph database by generating Cypher from natural language, grounded in the actual schema.

What it does

Schema retrieval. Node labels, relationship types, and property keys, fetched before any query is written. This is the critical piece — Cypher generated without the schema is confidently wrong.
Read queries for traversals, pattern matching, and aggregation
Write queries for creating and updating nodes and relationships, when enabled

Why it suits graphs particularly well

Cypher is expressive but unfamiliar, and graph questions are naturally phrased in language: "which customers are connected to this account through more than two hops", "what depends on this service". Translating those into traversals is exactly the kind of task where an assistant with the schema in hand does well.

Setup

uvx mcp-neo4j-cypher with connection details in environment variables. Works against local instances, self-managed clusters, and Neo4j Aura. Companion servers in the same repository cover Aura instance management and knowledge-graph memory.