Skip to main content
MCP server CX Codex

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 GitHub

What 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 the shop entity.
  • 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

From the same set4

Project sponsors

Companies that keep this analytics open