Neo4j Memory — Claude Code MCP server: what it does, how to install
Neo4j Memory gives an agent long-term memory in a Neo4j graph: entities, relations and observations that outlive a single session.
MIT ★ 991 updated 2026-09-09
Open on GitHubWhat Neo4j Memory does
The server keeps an agent's notes in a graph. Memory nodes carry a name, a type and observations, and typed relations connect them. Tools cover reading (read_graph, search_nodes, find_nodes), creating and deleting entities and relations, and adding or removing observations. The agent reaches for them on its own once you ask it to remember something.
Run it with uvx [email protected] or the mcp/neo4j-memory:0.4.5 Docker image. STDIO is the default transport; SSE and HTTP also work (--transport http, defaults to 127.0.0.1:8000 on /mcp/). Add --namespace to prefix every tool name, so two apps can share one server.
You need a Neo4j instance, local or hosted on Aura, plus its address and credentials: pass them as --db-url, --username and --password, or through NEO4J_URL, NEO4J_USERNAME and NEO4J_PASSWORD. HTTP mode answers only requests for localhost and 127.0.0.1 until you list other hosts in NEO4J_MCP_SERVER_ALLOWED_HOSTS, which matters the moment a proxy sits in front.
What it helps with
- keep project facts between agent sessions
- look up every entity tied to one person
- attach a new observation to an existing entity
- drop an entity together with its relations
- split two apps with separate namespaces
Example prompts for the agent
- Remember that billing talks to
api.internal, and link it to theshopentity. - Search memory for every node connected to
Postgres. - Show the whole graph, then delete the observation about the old stack.
How to install Neo4j Memory
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Neo4j Memory
How do I install Neo4j Memory in Claude Code?
Install the package with pip install mcp-neo4j-memory, then add the server to claude_desktop_config.json using the command uvx [email protected] with --db-url, --username and --password.
What does Neo4j Memory do?
It stores an agent's entities, relations and observations in a Neo4j graph, so that knowledge stays queryable in later sessions.
Which hosts can reach the HTTP transport?
Only localhost and 127.0.0.1, until you extend NEO4J_MCP_SERVER_ALLOWED_HOSTS.