Neo4j MCP Clients & Servers

Neo4j MCP Clients & Servers

What is Neo4j MCP Clients & Servers about? Enables large language models to communicate with Neo4j graphs and Aura cloud services via standardized MCP messages. Four dedicated servers translate natural‑language prompts into Cypher, store and retrieve knowledge‑graph entities, manage Aura instances, and support interactive data‑modeling.

How to use Neo4j MCP Clients & Servers?

1. Choose a server based on the desired capability:
   • mcp-neo4j-cypher – generate and run Cypher queries.
   • mcp-neo4j-memory – store/retrieve entities in a Neo4j knowledge graph.
   • mcp-neo4j-cloud-aura-api – create, scale, and delete Aura databases.
   • mcp-neo4j-data-modeling – design, validate, and visualize graph data models.
2. Run the server in the preferred transport mode (STDIO, SSE, or HTTP). Example for HTTP:

   mcp-neo4j-cypher --transport http --host 127.0.0.1 --port 8080 --path /api/mcp/
   

3. Connect an MCP client (Claude Desktop, VS Code extension, Cursor, etc.) and issue natural‑language commands.
4. The server replies with results, visualizations, or confirmation messages.

Key features of Neo4j MCP Clients & Servers

• Four specialized MCP servers covering query execution, knowledge‑graph memory, Aura management, and data‑modeling.
• Multi‑mode transport: STDIO for local tools, Server‑Sent Events for web UIs, streamable HTTP for micro‑service deployments.
• Environment‑variable support for HTTP configuration (host, port, path, transport type).
• Seamless integration with Claude Desktop and other MCP‑compatible clients.
• Open‑source MIT‑licensed implementation.

Use cases of Neo4j MCP Clients & Servers

• Ask an AI assistant “What products are top‑selling?” and receive a chart generated from Cypher results.
• Persist facts like “Worked on Neo4j MCP Servers with Andreas and Oskar” in a personal knowledge graph for future retrieval.
• Programmatically provision a new Aura instance (mcp-neo4j-cloud-aura-api) during CI pipelines.
• Collaboratively design a graph schema, export to Arrows.app, and visualize it with mcp-neo4j-data-modeling.
• Build chat‑based analytics dashboards that query Neo4j in real time.

FAQ from the Neo4j MCP Clients & Servers

• Q: Which transport mode should I pick? A: Use STDIO for local development and Claude Desktop. Choose HTTP for containerized or cloud deployments; SSE works well for browser‑based UIs.
• Q: Do I need a Neo4j license? A: A running Neo4j instance (local or Aura) is required; Aura offers free dev tiers, and the servers work with any edition.
• Q: How are authentication credentials supplied? A: Provide Neo4j URI, username, and password via standard Neo4j driver environment variables (NEO4J_URI, NEO4J_USER, NEO4J_PASSWORD).
• Q: Can I run multiple servers simultaneously? A: Yes, each server runs on its own process and can listen on different ports or paths.
• Q: Is the project actively maintained? A: The repository is under Neo4j‑contrib and welcomes contributions via pull requests.

Neo4j MCP Clients & Servers

Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems.

This lets you use Claude Desktop, or any other MCP Client (VS Code, Cursor, Windsurf), to use natural language to accomplish things with Neo4j and your Aura account, e.g.:

• What is in this graph?
• Render a chart from the top products sold by frequency, total and average volume
• List my instances
• Create a new instance named mcp-test for Aura Professional with 4GB and Graph Data Science enabled
• Store the fact that I worked on the Neo4j MCP Servers today with Andreas and Oskar

Servers

mcp-neo4j-cypher - natural language to Cypher queries

Details in Readme

Get database schema for a configured database and execute generated read and write Cypher queries on that database.

mcp-neo4j-memory - knowledge graph memory stored in Neo4j

Details in Readme

Store and retrieve entities and relationships from your personal knowledge graph in a local or remote Neo4j instance. Access that information over different sessions, conversations, clients.

mcp-neo4j-cloud-aura-api - Neo4j Aura cloud service management API

Details in Readme

Manage your Neo4j Aura instances directly from the comfort of your AI assistant chat.

Create and destroy instances, find instances by name, scale them up and down and enable features.

mcp-neo4j-data-modeling - interactive graph data modeling and visualization

Details in Readme

Create, validate, and visualize Neo4j graph data models. Allows for model import/export from Arrows.app.

Transport Modes

All servers support multiple transport modes:

• STDIO (default): Standard input/output for local tools and Claude Desktop integration
• SSE: Server-Sent Events for web-based deployments
• HTTP: Streamable HTTP for modern web deployments and microservices

HTTP Transport Configuration

To run a server in HTTP mode, use the --transport http flag:

# Basic HTTP mode
mcp-neo4j-cypher --transport http

# Custom HTTP configuration
mcp-neo4j-cypher --transport http --host 127.0.0.1 --port 8080 --path /api/mcp/

Environment variables are also supported:

export NEO4J_TRANSPORT=http
export NEO4J_MCP_SERVER_HOST=127.0.0.1
export NEO4J_MCP_SERVER_PORT=8080
export NEO4J_MCP_SERVER_PATH=/api/mcp/
mcp-neo4j-cypher

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Blog Posts

• Everything a Developer Needs to Know About the Model Context Protocol (MCP)
• Claude Converses With Neo4j Via MCP - Graph Database & Analytics
• Building Knowledge Graphs With Claude and Neo4j: A No-Code MCP Approach - Graph Database & Analytics

License

MIT License