Overview
The mcp-neo4j project implements the Model Context Protocol (MCP) to facilitate interaction between large language models (LLMs) and Neo4j, allowing users to manage context in queries and responses.
Users can utilize MCP clients, such as Claude Desktop, to perform natural language queries to interact with their Neo4j graph databases and Aura accounts. For instance, users can ask, 'What is in this graph?'
- Implements the Model Context Protocol for efficient context management. - Allows issuing Cypher queries through natural language. - Enables memory storage in Neo4j and as JSON files.
- Queries made in natural language converted to Cypher for Neo4j.
- Using knowledge graphs for memory management in applications.
- Seamless integration for applications utilizing LLMs and graph databases.
Add to your AI client
Use these steps to connect Neo4j MCP Clients & Servers in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-neo4j-neo4j-contrib": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-neo4j-neo4j-contrib"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-neo4j-neo4j-contrib": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-neo4j-neo4j-contrib"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-neo4j-neo4j-contrib": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-neo4j-neo4j-contrib"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-neo4j-neo4j-contrib": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-neo4j-neo4j-contrib"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-neo4j-neo4j-contrib": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-neo4j-neo4j-contrib"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-neo4j-neo4j-contrib": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-neo4j-neo4j-contrib"
]
}
}
}FAQ
Can I use mcp-neo4j with any Neo4j instance?
Yes! mcp-neo4j can be utilized with any instance of Neo4j, including Aura accounts.
What types of memory storage does mcp-neo4j support?
It supports memory storage within Neo4j and in JSON format files.
How can I contribute to mcp-neo4j?
Contributions are welcomed, and you can submit Pull Requests to enhance the project.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":184,"uuid":"dc2ba603-de2b-4f75-930c-e743bf260f9f","name":"mcp-neo4j","title":"Neo4j MCP Clients & Servers","description":"Model Context Protocol with Neo4j","avatar_url":"https://avatars.githubusercontent.com/u/916372?v=4","created_at":"2024-12-13T09:12:25.317Z","updated_at":"2024-12-13T12:28:13.359Z","status":"created","author_name":"neo4j-contrib","author_avatar_url":"https://avatars.githubusercontent.com/u/916372?v=4","tags":"database,neo4j,mcp,stdio,mcp-server","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/neo4j-contrib/mcp-neo4j/","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"372\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-05-28 14:34:35\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]