Neo4j MCP
This lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things with Neo4j and your Aura account.
What is Neo4j MCP?
Neo4j MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this lets you use claude desktop, or any mcp client, to use natural language to accomplish things with neo4j and your aura account.
This lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things with Neo4j and your Aura account.
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This lets you use Claude Desktop, or any MCP Client, to use
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-neo4j-aura-managerPIP
pip install mcp-neo4j-aura-managerManual Installation
npx -y mcp-neo4j-aura-managerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Neo4j MCP
The Neo4j MCP suite provides four MCP servers that allow Claude Desktop and other MCP clients to interact with Neo4j graph databases using natural language, including executing Cypher queries, managing a persistent knowledge graph, controlling Neo4j Aura cloud instances, and designing graph data models. Users can ask questions in plain English and have the AI generate, validate, and execute Cypher queries against their graph database without needing to write query language manually. It is particularly valuable for teams working with connected data who want to explore and manage their graph databases conversationally.
Prerequisites
- Python 3.10+ and uv package manager, or npm/npx
- A running Neo4j database instance (local, Docker, or Neo4j Aura cloud)
- APOC plugin installed and enabled on your Neo4j instance (required for schema inspection)
- Claude Desktop or another MCP-compatible client
- For Aura management: a Neo4j Aura account with API credentials
Set up a Neo4j database
Ensure you have a Neo4j instance running. For quick local setup use Docker, or create a free Aura instance at console.neo4j.io.
docker run --name neo4j -p 7474:7474 -p 7687:7687 \
-e NEO4J_AUTH=neo4j/your-password \
-e NEO4JLABS_PLUGINS='["apoc"]' \
neo4j:latestInstall the mcp-neo4j-cypher server
Install the Cypher query server via pip or use it directly with uvx.
pip install mcp-neo4j-cypher
# Or use without installing:
uvx [email protected]Set your connection environment variables
Configure the Neo4j connection credentials as environment variables.
export NEO4J_URI=bolt://localhost:7687
export NEO4J_USERNAME=neo4j
export NEO4J_PASSWORD=your-password
export NEO4J_DATABASE=neo4jAdd the server to Claude Desktop config
Edit your claude_desktop_config.json to add the Neo4j MCP server entry with your connection credentials.
Restart Claude Desktop
Fully restart Claude Desktop to load the Neo4j MCP server. You should see Neo4j tools available in the tools panel.
Optionally install additional Neo4j MCP servers
Install the memory, Aura manager, or data modeling servers depending on your use case.
pip install mcp-neo4j-memory
npx -y mcp-neo4j-aura-managerNeo4j MCP Examples
Client configuration for Neo4j Cypher server
Claude Desktop configuration using the mcp-neo4j-cypher server with local Neo4j credentials.
{
"mcpServers": {
"neo4j-database": {
"command": "uvx",
"args": ["[email protected]", "--transport", "stdio"],
"env": {
"NEO4J_URI": "bolt://localhost:7687",
"NEO4J_USERNAME": "neo4j",
"NEO4J_PASSWORD": "your-password",
"NEO4J_DATABASE": "neo4j"
}
}
}
}Prompts to try
Example prompts for querying and managing Neo4j with natural language.
- "What is in this graph? Show me the schema and some example nodes"
- "Find all people who are connected to Alice within 3 hops in the social graph"
- "Render a chart of the top 10 products sold by frequency and total volume"
- "Create a new Neo4j Aura instance named 'mcp-test' with 4GB memory"
- "Store the fact that I worked with the Neo4j MCP server today and retrieve it next session"Troubleshooting Neo4j MCP
Schema inspection fails with 'APOC procedure not found' error
The APOC plugin must be installed and enabled on your Neo4j instance. For Docker, add -e NEO4JLABS_PLUGINS='["apoc"]' to your run command. For Neo4j Desktop, install APOC from the Plugin Manager.
Connection refused or timeout connecting to Neo4j
Verify the bolt port (7687) is accessible. Check NEO4J_URI matches your actual connection—use 'neo4j+s://' for Aura (TLS required) and 'bolt://' for local instances.
Queries succeed but return unexpected results
Use 'What is in this graph?' first to let Claude inspect the schema before writing queries. Neo4j is case-sensitive for label and property names, so schema inspection prevents typos.
Frequently Asked Questions about Neo4j MCP
What is Neo4j MCP?
Neo4j MCP is a Model Context Protocol (MCP) server that this lets you use claude desktop, or any mcp client, to use natural language to accomplish things with neo4j and your aura account. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Neo4j MCP?
Install via npm with the command: npx -y mcp-neo4j-aura-manager. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Neo4j MCP?
Neo4j MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Neo4j MCP free to use?
Yes, Neo4j MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Neo4j MCP Alternatives — Similar Databases Servers
Looking for alternatives to Neo4j MCP? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Neo4j MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Neo4j MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.