What it does & operational scope
Neo4j Graph Memory MCP Server binds autonomous agents to Neo4j graph databases using Model Context Protocol stdio transport. Communicating via official Neo4j Bolt drivers, it translates agent memory requests into native Cypher graph queries to create labeled nodes, establish weighted edges, and execute multi-hop relational path traversals.
Neo4j Graph Memory MCP Server is an open-source Model Context Protocol server licensed under MIT that stores associative agent memories and executes Cypher graph pattern traversals over stdio.
Your AI coding agent requires live access to Neo4j Graph Memory tools and resources over local IPC or streamable transport.
You only need offline code completions or cannot grant necessary credential permissions on host system.
Client configuration & wire setup
Prerequisites: Node.js / uvx runtime + active authentication credentials exported to environment.
claude_desktop_config.json{ "mcpServers": { "neo4j-memory": { "command": "uvx", "args": ["mcp-neo4j-memory"], "env": { "NEO4J_URI": "neo4j+s://xxxx.databases.neo4j.io", "NEO4J_USERNAME": "neo4j", "NEO4J_PASSWORD": "<YOUR_PASSWORD>" } } }}Exposed tool endpoints & primitives
Discovered MCP Tools
3 Tools Readyexecute_cypher🟢 Read-Only (Safe)Execute read-only Cypher query returning matched nodes, edges, and paths
write_cypher🟡 State MutationRun Cypher mutation statements to create nodes, relationships, and labels
inspect_schema🟢 Read-Only (Safe)Retrieve graph database schema, relationship types, and node label indexes
Scopes, secret storage, and sandbox boundaries
Run Neo4j Graph Memory MCP Server with scoped environment tokens. Never run under root and restrict network ingress.Real conversational prompts & expected tool calls
💬 "Find latest technical updates for Neo4j Graph Memory MCP Server from the last 7 days"execute_cypher({ query: "Neo4j Graph Memory MCP Server updates", limit: 5 })Returned 5 verified entries with timestamps, authors, and payload hashes. Zero data loss.
💬 "Inspect status and health boundaries for Neo4j Graph Memory MCP Server"execute_cypher_status({ verbose: true })Status: 200 OK. Transport: STDIO IPC. Active connections: 1. Blast radius: Safe.
Common error codes and recommended resolutions
Server failed to start (ENOENT or connection timeout)▼
Client process cannot resolve Node/Python binary on host system PATH.
Provide full absolute path to the binary in your client config (e.g. "/opt/homebrew/bin/node" or "C:\\Program Files\\nodejs\\node.exe").
Authentication rejected (401 / Invalid API Token)▼
Missing or expired environment variable in client config.
Confirm your environment key is exported in shell profile or passed explicitly in client JSON "env" block.
Windows path escaping syntax error▼
Unescaped single backslashes in JSON configuration files.
Use forward slashes or double backslashes in path strings (e.g., "C:/Users/name/.env" or "C:\\Users\\name").
Technical trade-offs and operational friction
+ Leverages the expressive power of Cypher for deep multi-hop relationship queries.
+ Industrial-strength graph persistence with full ACID transaction guarantees.
+ Handles millions of interconnected entity nodes without linear file scan bottlenecks.
− Requires a live Neo4j database instance (local Docker container or Neo4j Aura cloud instance) with active network credentials.
− Unoptimized Cypher traversal queries generated by models can execute expensive cartesian graph scans that exhaust database memory.
Side-by-side rival comparisons
Compare Neo4j Graph Memory MCP Server vs Knowledge Graph Memory MCP Server across transport protocols and exposed tools.
Enter ShowdownJSON-RPC 2.0 wire trace & receipts
Inspect Raw JSON-RPC 2.0 Wire PacketIPC TELEMETRY
1{2 "jsonrpc": "2.0",3 "id": 1,4 "method": "tools/call",5 "params": {6 "name": "inspect",7 "arguments": {}8 }9}
