Neo4j — Claude Code MCP server: graph queries
Connect an AI coding assistant to a Neo4j graph to inspect its schema and work with data through Cypher queries.
no license updated 2026-10-29
Open on GitHubWhat Neo4j does
The server lets an assistant inspect node labels, relationship types, and property keys before querying a graph. Its tools cover schema discovery, Cypher reads and writes, data inspection, and listing GDS procedures.
Install the package from PyPI with pip install neo4j-mcp-server. To connect it, configure the Neo4j address, username, password, and database as environment variables, then run the server as a Python module.
Neo4j checks read queries, but custom procedures or functions classified incorrectly can get past that check. Set NEO4J_MCP_READ_ONLY=true to disable write queries.
What it helps with
- inspect node labels and relationship types in a graph
- query Neo4j data with Cypher
- write graph changes through Cypher
- list available GDS procedures
Example prompts for the agent
- Inspect my Neo4j graph and report its node labels and relationship types.
- Find graph records that match this condition using Cypher.
- Add these nodes and relationships to Neo4j with a Cypher query.
How to install Neo4j
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Neo4j
How do I install the Neo4j MCP server for Claude Code?
Install the package with pip install neo4j-mcp-server. Configure the MCP server with your Neo4j address, username, password, and database.
What does the Neo4j MCP server do?
It gives an AI assistant tools to inspect a graph schema and work with graph data using Cypher. It can also list GDS procedures.
Can I prevent the server from writing to the database?
Yes. Set NEO4J_MCP_READ_ONLY=true to turn off the write-query tool.