MCP server

Neo4j MCP Server

Run Cypher queries, model graph data and store agent memory in Neo4j. Official: built and maintained by Neo4j. It runs locally on your machine over stdio. Setup below for 12 clients (checked 2026-10-25). Repo and registry data checked 2026-10-24.

Maintainer: Official · Neo4j
Runs: Local (stdio)
Repo: neo4j-contrib/mcp-neo4j
GitHub: ★ 989, last push 2026-09-09 (checked 2026-10-24)
License: MIT
Registry: io.github.neo4j-contrib/mcp-neo4j-cypher
Connects to: Neo4j

Install the Neo4j MCP Server

Pick your client. Each tab starts the same local command. Config shapes checked against each client's docs on 2026-10-25.

Needs NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD (replace the ... with your value).

Run in a terminal. Everything after -- is the command that starts the server. docs

claude mcp add --transport stdio --env NEO4J_URI=... --env NEO4J_USERNAME=... --env NEO4J_PASSWORD=... neo4j -- uvx mcp-neo4j-cypher

Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs

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

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs

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

Add to Cursor

Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs

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

Add to VS Code

Run codex mcp add --env NEO4J_URI=... --env NEO4J_USERNAME=... --env NEO4J_PASSWORD=... neo4j -- uvx mcp-neo4j-cypher, or add this to ~/.codex/config.toml. docs

[mcp_servers.neo4j]
command = "uvx"
args = ["mcp-neo4j-cypher"]

[mcp_servers.neo4j.env]
NEO4J_URI = "..."
NEO4J_USERNAME = "..."
NEO4J_PASSWORD = "..."

Run in a terminal (-s user adds it for all projects; the default is this project). docs

gemini mcp add -s user -e NEO4J_URI=... -e NEO4J_USERNAME=... -e NEO4J_PASSWORD=... neo4j uvx mcp-neo4j-cypher

Run in a terminal; it writes ~/.copilot/mcp-config.json. docs

copilot mcp add --env NEO4J_URI=... --env NEO4J_USERNAME=... --env NEO4J_PASSWORD=... neo4j -- uvx mcp-neo4j-cypher

Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs

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

Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs

{
  "context_servers": {
    "neo4j": {
      "command": "uvx",
      "args": [
        "mcp-neo4j-cypher"
      ],
      "env": {
        "NEO4J_URI": "...",
        "NEO4J_USERNAME": "...",
        "NEO4J_PASSWORD": "..."
      }
    }
  }
}

Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "neo4j": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-neo4j-cypher"
      ],
      "enabled": true,
      "environment": {
        "NEO4J_URI": "...",
        "NEO4J_USERNAME": "...",
        "NEO4J_PASSWORD": "..."
      }
    }
  }
}

Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs

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

MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs

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

Security notes

The local server runs with your user's permissions (uvx downloads it from PyPI on first run).
Needs NEO4J_URI, NEO4J_USERNAME and NEO4J_PASSWORD. Use a key or token with the narrowest scopes (read-only if there is one), and keep it out of config files you commit (.mcp.json, .vscode/mcp.json).
Connect it to a development database or a read-only user first: the model can run writes and deletes if the credentials allow them.

Alternatives

all database MCP servers →

MCP Toolbox for Databasesofficial · ★ 17k
One server for Postgres, MySQL, SQL Server, BigQuery, AlloyDB, Spanner and more, with tools you define in YAML.
Convexofficial · ★ 13k
Read tables, run functions and inspect logs of a Convex deployment.
Firebaseofficial · ★ 4.5k
Firestore, Auth, Data Connect, Storage and Remote Config tools, built into the Firebase CLI.
Supabaseofficial · ★ 3k
Query Postgres, manage tables, migrations, edge functions and branches in your Supabase projects.
Qdrantofficial · ★ 1.6k
Store and search memories in a Qdrant vector collection.
SQL MCP Server (Data API builder)official · ★ 1.5k
Self-hosted server that exposes chosen SQL tables, views and procedures as safe CRUD tools.
MongoDBofficial · ★ 1.2k
Query and manage MongoDB databases and Atlas clusters.
ClickHouseofficial · ★ 892
Run read-only SQL against ClickHouse and list databases and tables.

FAQ

What does the Neo4j MCP Server do?+

Run Cypher queries, model graph data and store agent memory in Neo4j.

Is the Neo4j MCP server official?+

Official: built and maintained by Neo4j.

How do I add Neo4j to Claude Code?+

Run: claude mcp add --env NEO4J_URI=... --env NEO4J_USERNAME=... --env NEO4J_PASSWORD=... --transport stdio neo4j -- uvx mcp-neo4j-cypher. Add --scope project to share it with your team through .mcp.json.

How do I use the Neo4j MCP server in Cursor or VS Code?+

Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("stdio").

Does Neo4j work in ChatGPT and claude.ai?+

No: it runs locally over stdio, and ChatGPT and claude.ai only connect to remote servers. Use it in Claude Desktop, Claude Code, Cursor, VS Code or another client that can start a local process.

What are the alternatives to the Neo4j MCP server?+

Other database MCP servers: MCP Toolbox for Databases, Convex, Firebase, Supabase and Qdrant.

All MCP servers · What is an MCP server? · Agent skills