---
title: "Neo4j MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/neo4j/
description: "Explore a Neo4j graph schema and run Cypher through a server with an explicit read-only configuration."
---

# Neo4j MCP: review, setup & limitations · Undominated.ai

> Explore a Neo4j graph schema and run Cypher through a server with an explicit read-only configuration.

[← Explore all mcp servers](/mcp-servers/)

DATABASE EXPLORATION / Neo4j

# Neo4j MCP

Explore a Neo4j graph schema and run Cypher through a server with an explicit read-only configuration.

 [See setup guidance ↓](#setup)[Original source ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/README.md)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 8 linked sources
 Publisher Neo4j
 Licence [GPL-3.0; Neo4j Aura/commercial-product terms where applicable ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/LICENSE.txt)
 Revision 0f851d06092a
 [Read what was—and wasn’t—checked ↓](#review)

“Neo4j MCP gives AI assistants and LLM-powered tools direct, structured access to your Neo4j graph database.”

 [Neo4j · upstream description ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Schema introspection helps an agent discover graph labels, relationships and properties before writing queries.
- The read-only setting removes the write-Cypher tool, with separate database credentials still controlling access.

### A good fit for

 - Explore an existing Neo4j graph.
- Develop reviewed Cypher queries against a non-production database.

### Weigh up before choosing

 - Write mode is available and is the configuration default; set NEO4J_MCP_READ_ONLY=true when appropriate.
- Read-Cypher checking relies on Neo4j query classification; misclassified custom procedures/functions can bypass that intended boundary.
- Telemetry defaults on in the inspected configuration; use the documented setting if you need it disabled.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md, go.mod, cmd/neo4j-mcp/main.go, internal/config/config.go and internal/server/tools_register.go at 0f851d06092ab6e2914af55662d11a226efe8924.
- internal/tools/cypher/read_cypher_handler.go, LICENSE.txt and NOTICE.txt at the same commit; the installation and configuration pages on neo4j.com, read 2026-10-13.

### Our findings

 - The implementation is Go even though the README also offers a Python distribution wrapper.
- Stdio uses environment credentials; HTTP mode takes per-request credentials. The configuration page names Bearer token or Basic authentication; config.go rejects a username and password set for HTTP mode.
- The README lists four tools: get-schema, read-cypher, write-cypher (disabled when NEO4J_MCP_READ_ONLY=true) and list-gds-procedures.
- config.go reads both NEO4J_MCP_* and NEO4J_* names for each setting; the README uses the first, the configuration page the second. ReadOnly defaults to false and Telemetry to true.
- configExample is the README's VS Code mcp.json block at 0f851d06; its NEO4J_MCP_PASSWORD value is the README's placeholder.
- The README and the files cited here are byte-identical between 905121a3 and 0f851d06.

### Not established by this review

 - Server launch, authenticated tool calls, and release-to-source parity were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/README.md)

DOCUMENTED COMMAND

 pip install neo4j-mcp-server Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Install using the PyPI command above, or the documented Homebrew (brew install neo4j-mcp) or release-binary route.
- Configure the database URI, database and credentials in your client; set NEO4J_MCP_READ_ONLY=true for exploration.
- Follow the separate HTTP instructions if exposing a listener, including authentication and TLS configuration.
- The command was copied from the README and not run.

### Before you start

 - An accessible Neo4j database and credentials.
- Python for the shown distribution route, or the platform-appropriate native executable.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "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",
 "NEO4J_MCP_READ_ONLY": "true",
 "NEO4J_MCP_TELEMETRY": "false",
 "NEO4J_MCP_LOG_LEVEL": "info",
 "NEO4J_MCP_LOG_FORMAT": "text",
 "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
 }
 }
 }
} Copy configuration ↗

### Compatibility

VS Code · Claude · Cursor

### Implementation

Go

### Transports

stdio · Streamable HTTP

### Database credentials

 - Reads graph schema and query results.
- Can run write Cypher unless disabled; database privileges remain important even in read-only mode.
- Authenticates to Neo4j with a username and password from the environment (stdio) or per-request Bearer or Basic credentials (HTTP).

### Cost model

Neo4j hosting or Aura plan and connected AI-client charges are separate.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Neo4j MCP setup and scope ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/README.md) Checked 2026-10-13 https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/README.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review, configExample
- [Neo4j MCP installation routes ↗](https://neo4j.com/docs/mcp/current/installation/) Checked 2026-10-13 https://neo4j.com/docs/mcp/current/installation/ Supports: install, compatibility
- [Neo4j MCP configuration ↗](https://neo4j.com/docs/mcp/current/configuration/) Checked 2026-10-13 https://neo4j.com/docs/mcp/current/configuration/ Supports: limitations, install, access, transports
- [Neo4j transport, credentials and defaults ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/internal/config/config.go) Checked 2026-10-13 https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/internal/config/config.go Supports: language, review, limitations, transports
- [Neo4j read-only tool filtering ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/internal/server/tools_register.go) Checked 2026-10-13 https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/internal/server/tools_register.go Supports: review, access
- [Neo4j read query handler ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/internal/tools/cypher/read_cypher_handler.go) Checked 2026-10-13 https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/internal/tools/cypher/read_cypher_handler.go Supports: review, limitations
- [Neo4j source licence ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/LICENSE.txt) Checked 2026-10-13 https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/LICENSE.txt Supports: license
- [Neo4j distribution and service-agreement notice ↗](https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/NOTICE.txt) Checked 2026-10-13 https://raw.githubusercontent.com/neo4j/mcp/0f851d06092ab6e2914af55662d11a226efe8924/NOTICE.txt Supports: license, limitations

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### AWS Labs MCP Server for Oracle Database ↗ Pins the Oracle server whose README defaults to read-only SQL and keeps the secret ARN off the tool surface.](/mcp-servers/awslabs-oracle/)[### Couchbase MCP Server ↗ Self-hosted Couchbase server with cluster health, schema, key-value, SQL++ and performance tools. Read-only mode is on by default, individual tools can be disabled, and the underlying Couchbase RBAC remains the authoritative boundary across stdio, Streamable HTTP and SSE transports.](/mcp-servers/couchbase/)[### MongoDB MCP Server ↗ Provides MongoDB database and Atlas operations through a local server with an explicit read-only startup option.](/mcp-servers/mongodb/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
