Neo4j MCP Server
A Neo4j MCP server implementation for managing graph database operations through the Model Context Protocol
Overview
Neo4j MCP Server is an implementation designed to manage graph database operations through the Model Context Protocol, allowing seamless interaction with Neo4j databases.
To use the Neo4j MCP Server, you can run it directly using npx with your Neo4j connection details or install it globally via npm. Configuration can be done through environment variables or a .env file.
- Supports both single connection strings and separate environment variables for configuration. - Compatible with Cursor and Claude Desktop for enhanced usability. - Allows execution of Cypher queries against the Neo4j database.
- Managing and querying graph databases efficiently.
- Integrating with development environments like Cursor for streamlined database operations.
- Facilitating the setup of Neo4j servers in various applications.
Add to your AI client
Use these steps to connect Neo4j MCP Server 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": {
"neo4j-mcpserver-tobarrientos2": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neo4j-mcpserver-tobarrientos2"
]
}
}
}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": {
"neo4j-mcpserver-tobarrientos2": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neo4j-mcpserver-tobarrientos2"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"neo4j-mcpserver-tobarrientos2": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neo4j-mcpserver-tobarrientos2"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"neo4j-mcpserver-tobarrientos2": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neo4j-mcpserver-tobarrientos2"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"neo4j-mcpserver-tobarrientos2": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neo4j-mcpserver-tobarrientos2"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"neo4j-mcpserver-tobarrientos2": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-neo4j-mcpserver-tobarrientos2"
]
}
}
}FAQ
Can I run Neo4j MCP Server without installing it globally?
Yes! You can run it directly using npx without global installation.
What should I do if I encounter issues?
Verify your Neo4j credentials, check for path issues, and ensure the server is running properly.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1359,"uuid":"936e46e0-9a97-437d-bf44-89d637a64786","name":"neo4j-mcpserver","title":"Neo4j MCP Server","description":"A Neo4j MCP server implementation for managing graph database operations through the Model Context Protocol","avatar_url":"https://avatars.githubusercontent.com/u/127901334?v=4","created_at":"2025-02-20T15:29:28.704+00:00","updated_at":"2025-02-23T07:21:16.736+00:00","status":"created","author_name":"Tobarrientos2","author_avatar_url":"https://avatars.githubusercontent.com/u/127901334?v=4","tags":"neo4j,graph-database,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/Tobarrientos2/neo4j-mcpserver","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"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"}]]}]