Menu

AI

Neo4j MCP Server: Tools, Setup and Security

Neo4j's official MCP server lets AI apps read your graph schema and run Cypher queries. Learn its four tools, read-only mode, HTTP mode and telemetry setting.

By: Irina ShvayaNovember 2, 2026

Neo4j MCP Server: Tools, Setup and Security

This profile is part of our MCP server directory, within The MCP Guide. Profiles are checked against each vendor's own documentation. Need a server built? See MCP development.

The Neo4j MCP server gives AI apps structured access to a Neo4j graph database. Your assistant can read the graph schema, run read-only Cypher queries, and, if you allow it, run write queries. It works with Aura, Neo4j Desktop and self-managed Neo4j.

Checked against: the Neo4j MCP documentation (Version 2), its configuration, installation and tools pages, and the neo4j/mcp GitHub README (release v2.0.0, published 28 October 2026), checked on 2 November 2026. eSEOspace did not install or test this server.

Key Takeaways

  • There are four tools: get-schema, read-cypher, write-cypher and list-gds-procedures.
  • Read-only mode (NEO4J_MCP_READ_ONLY=true or --read-only) hides write-cypher, even if you list it in the tool selection.
  • Neo4j's own docs warn that LLM-generated write queries "can cause harm" and say to use write-cypher only in development.
  • Telemetry is on by default; turn it off with NEO4J_MCP_TELEMETRY=false.
  • Neo4j Labs runs separate, experimental servers such as mcp-neo4j-cypher; neo4j/mcp is the official product server.

At a glance

ItemDetail
PublisherNeo4j
Official?Yes
HostingSelf-hosted (pip/uvx, Homebrew or release binary)
Transportstdio (default) or stateless HTTP
Sign-inNeo4j username and password (stdio); per-request credentials in a header (HTTP)
Read or writeRead-write by default; read-only mode available
PriceFree to download; you need a running Neo4j instance
Source codeOpen (Go); GPL v3 per NOTICE.txt, with different terms when used with Aura or Neo4j's commercial products
Statusv2.0.0

What it can do

The tools page lists:

ToolRead-onlyPurpose
get-schemaYesReads labels, relationship types and property keys
read-cypherYesRuns Cypher in read mode; rejects writes, schema/admin operations and PROFILE
write-cypherNoRuns Cypher in write mode
list-gds-proceduresYesLists Graph Data Science procedures on the instance

Neo4j suggests prompts such as listing all node labels and relationship types, or creating a node. Prerequisites are a running Neo4j instance with the APOC plugin. The Graph Data Science (GDS) library is optional; if it is missing, list-gds-procedures is simply left out.

read-cypher makes an extra round trip to confirm a query is read-only. The README adds one caveat: custom procedures that Neo4j wrongly classifies as read-only may slip past that check.

How to connect it

Neo4j's installation page gives these options:

uvx neo4j-mcp-server
brew install neo4j-mcp

You can also download a binary from the GitHub releases page and run neo4j-mcp -v to confirm it works. The README shows pip install neo4j-mcp-server and this VS Code mcp.json entry (we removed a trailing comma from the README copy so the JSON is valid):

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j"
      }
    }
  }
}

Claude Desktop, Cursor and other clients take the same command and env block under mcpServers. Our MCP config generator can reformat it.

All settings use the NEO4J_MCP_ prefix, and each has a matching command-line flag that wins over the variable. Other useful ones from the configuration page: NEO4J_MCP_TOOLS to advertise only some tools, NEO4J_MCP_REQUEST_TIMEOUT (default 3 minutes, max 30), and NEO4J_MCP_SCHEMA_SAMPLE_SIZE (default 100 nodes).

HTTP mode

Set NEO4J_MCP_TRANSPORT_MODE=http for a stateless, multi-tenant server. In this mode the URI and credentials come from request headers, and the database comes from the URL path /db/{databaseName}/mcp. It binds to 127.0.0.1 by default, CORS is off unless you set allowed origins, and TLS is available with a certificate and key file.

Security notes

Start with read-only mode. It takes precedence over tool selection, so write-cypher stays hidden even if someone adds it to NEO4J_MCP_TOOLS. Neo4j's tools page puts it plainly: "LLM-generated queries can cause harm. Use only in development environments."

Use a Neo4j user with only the privileges the assistant needs. In stdio mode the password sits in your client config, so keep that file private. In HTTP mode, credentials travel with each request; enable TLS and keep NEO4J_MCP_HTTP_ALLOW_UNAUTHENTICATED_PING off unless a health check needs it.

Telemetry defaults to true. If your policy requires it, set NEO4J_MCP_TELEMETRY=false or use the --telemetry flag. Check other risks with our MCP server risk checklist, and read least privilege for MCP and the MCP Security Center.

Alternatives

Next step

Connect in read-only mode, ask for the schema, then try a few read questions. Compare other options in our best MCP servers for databases list.

More in the MCP Guide

Free tools: MCP Server Risk Checklist · Tool Permission Planner

Latest research: State of MCP: October 2026

Frequently asked questions

Is the Neo4j MCP server free?

The server is free to download from PyPI, Homebrew or GitHub. You need a Neo4j instance, which may be free or paid depending on whether you use Aura, Desktop or a self-managed edition.

How do I stop the AI from changing my graph?

Set NEO4J_MCP_READ_ONLY=true or pass --read-only. That hides write-cypher. Pair it with a database user that has only read privileges.

What is the difference between neo4j/mcp and mcp-neo4j-cypher?

neo4j/mcp is the official product server. mcp-neo4j-cypher and related servers belong to Neo4j Labs, whose README says they are "not supported by the Neo4j product team" and carry no backwards-compatibility guarantees.

Does it work with Neo4j Aura?

Yes. Neo4j lists Aura, Neo4j Desktop and self-managed deployments as supported instances. Point NEO4J_MCP_URI at your Aura connection URI.

You Might Also like to Read

Get a FREE Website Audit

Enter your website and get a 20–30 page SEO, GEO, AEO & CRO audit within 24 hours. Completely free.

Don't have a site yet? Get in touch →

Ready to speak with a marketing expert?
Give us a call! (916) 866-7893

Websites Launched
1407
Websites Launched
Marketing Experts
29
Marketing Experts
Hours of Dedicated Work
204533
Hours of Dedicated Work
Irina S.Benjamin G.Jeanette M.David G.