# Neo4j Memory

Neo4j Memory gives an agent long-term memory in a Neo4j graph: entities, relations and observations that outlive a single session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 991 repo stars
- Author: neo4j-contrib
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/neo4j-contrib/mcp-neo4j/tree/HEAD/servers/mcp-neo4j-memory
- Updated: 2026-09-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/neo4j-memory

## What it 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 mcp-neo4j-memory@0.4.5` 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- 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.

## Similar
- [neo4j-agent-memory-skill](https://affpapa.org/en/nevibecode/skills/neo4j-agent-memory-skill.md) — skill · 940 installs
- [neo4j-mcp-skill](https://affpapa.org/en/nevibecode/skills/neo4j-mcp-skill.md) — skill · 590 installs
- [spring-data-neo4j](https://affpapa.org/en/nevibecode/skills/spring-data-neo4j.md) — skill · 4000 installs
- [Neo4j](https://affpapa.org/en/nevibecode/mcp/neo4j.md) — MCP server
- [neo4j-cypher-guide](https://affpapa.org/en/nevibecode/skills/neo4j-cypher-guide.md) — skill · 1 install
- [neo4j-expert](https://affpapa.org/en/nevibecode/agents/neo4j-expert.md) — subagent · ★ 1029 repo stars

From the same set: [neo4j-contrib/mcp-neo4j](https://affpapa.org/en/nevibecode/by/neo4j-contrib/mcp-neo4j.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
