# nMEMORY

A persistent memory MCP server for coding agents that links every stored item to an exact anchor. When information is missing, it explicitly states so.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 9
- Author: menot-you
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/menot-you/n-memory
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/nmemory

## What it does

The server keeps state across runs inside a single local SQLite store. Every recorded entry requires an anchor, such as a file path with a line number, a quotation, or a pull request link. Search queries return one of three explicit results: `grounded`, `missing_evidence`, or `abstain`. It never guesses when data falls short.

The toolset exposes 27 MCP handlers covering record ingestion, recall, handoffs, and audit inspection. BM25 keyword matching operates on the local machine with no external accounts. Vector embeddings run only after setting credentials such as `GEMINI_API_KEY` or configuring `NOTT_NMEMORY_EMBED_PROVIDER` for servers like Ollama or vLLM.

The database file never initializes itself in the background. You must create the initial store manually via `uv run nmemory database create`. The project environment relies on Python 3.14 or later managed through `uv`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

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

## When to use it
- preserve project decisions across sessions with exact file references
- stop agent hallucinations by returning explicit missing-evidence statuses
- pass working context across coding sessions using structured handoffs
- inspect an auditable hash-chained record of all memory modifications

## Example prompts
- Store our database choice in memory with an anchor to `docs/adr/0001-storage.md`
- Search memory for our data storage decisions and verify their sources
- Finalize the current session and write a handoff summary for the next agent

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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