Skip to content
MCP server

Mnemodb

Agent memory kept as plain Markdown files in your repo, with provenance and lifecycle

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.22
Listing updated
today

Similar MCP servers

About Mnemodb

Mnemodb is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

MnemoDB defines a .mem.md format where each memory is a Markdown heading with a one-line metadata span recording an id, source, confidence and what it supersedes. Because it is plain text, it renders anywhere and diffs in git. Existing CLAUDE.md or AGENTS.md files already count as valid untyped files.

Provenance is the core idea. Every entry is marked as coming from the user, the agent or a tool. Tool-sourced entries come back flagged untrusted, cannot be pinned into every session and cannot supersede or retire a trusted entry. The README is candid that the agent applies the label itself, so it catches honest mistakes rather than a determined injection.

Memories can carry TTLs and supersession, and a compact pass archives expired or replaced ones. The README says it is early (v0.1) and may be overkill if a short hand-kept CLAUDE.md already does the job.

Install

Run in a terminal

claude mcp add mnemodb -- npx -y @mnemodb/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mnemodb": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemodb/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mnemodb": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemodb/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mnemodb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mnemodb/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mnemodb": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemodb/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mnemodb": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemodb/mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MNEMO_STOREDirectory containing the .memory/ store. If unset, the server uses CLAUDE_PROJECT_DIR (set by Claude Code), then the working directory. An empty value is an error: the server refuses rather than writing the store somewhere that will not persist.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

memory_recall
Recall stored memories.
memory_list
List memories.
memory_show
Show one memory entry.
memory_history
Show an entry's supersession lineage.
memory_stats
Report on the store itself.
memory_remember
Save a memory.
memory_forget
Forget a memory auditably, gated by trust.
memory_pin
Control what loads into context.
memory_review
Review memories.
memory_compact
Archive expired or replaced memories.
memory_boot
Boot-time memory loading.

What it does

Plain Markdown store
A .memory/ folder of .mem.md files you can read, edit and diff.
Provenance labels
Entries record user, agent or tool origin; tool entries are untrusted on recall.
Lifecycle rules
TTLs, supersession and a compact pass that archives expired entries.
Auditable forgetting
memory_forget is trust-gated and never erases a higher-trust memory.
Store health checks
The mnemo doctor command lints for staleness, contradictions and damage.
Cross-tool portability
Works with Claude Code, Cursor and other MCP clients.

Good for

  • Keep decisions and preferences across Claude Code sessions
  • Audit what an agent learned with git diff
  • Trace everything saved from tool output after a suspected injection
  • Share one memory store between Claude Code and Cursor

Pricing

Open source

Free; Apache-2.0 code, CC BY 4.0 spec

Mnemodb FAQ

How do I install it?

Run claude mcp add mnemodb -- npx -y @mnemodb/mcp@latest, or use the Claude Code plugin.

What is the licence?

Apache-2.0 for the code and CC BY 4.0 for the spec.

Where is memory stored?

In a .memory/ directory chosen by MNEMO_STORE, or Claude Code's project directory, or the working directory.

How many tools does it expose?

Eleven memory tools, from memory_recall to memory_boot.

Is Mnemodb free?

Yes. Mnemodb is open source, so you can use and self-host it for free.

How do I add Mnemodb to Claude Code?

Run this command in your terminal: claude mcp add mnemodb -- npx -y @mnemodb/mcp

What are the best alternatives to Mnemodb?

The closest alternatives to Mnemodb are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers