Skip to content
MCP server

Mnemolith

Project memory for Claude Code, Cursor and Codex that retires facts when code changes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.4.3
Listing updated
2 days ago

About Mnemolith

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

Mnemolith ties each saved fact to the files it describes and stores a git content hash of those files. When docker-compose.yml changes, a memory about it is flagged instead of being fed to the next session, and a contradicting statement such as a move from Postgres to MySQL replaces the old one. Near-identical repeats are merged.

Everything runs locally on a database engine the author says he wrote from scratch in Java, speaking a Redis-compatible protocol and including an HNSW vector index for semantic search. A Python layer handles embeddings, git hashing and the MCP server. Current memories can sync into a managed section of AGENTS.md and CLAUDE.md so teammates see them in pull requests.

Running mnemolith ui opens a browser dashboard where stale memories show the file versions side by side for you to confirm or retire. The README also reports a small test of seven tasks run three times: 21 of 21 correct with Mnemolith against 9 of 21 with no memory.

Install

Run in a terminal

claude mcp add mnemolith -- uvx mnemolith

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mnemolith": {
      "command": "uvx",
      "args": [
        "mnemolith"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mnemolith": {
      "command": "uvx",
      "args": [
        "mnemolith"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mnemolith": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mnemolith"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mnemolith": {
      "command": "uvx",
      "args": [
        "mnemolith"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mnemolith": {
      "command": "uvx",
      "args": [
        "mnemolith"
      ]
    }
  }
}

Tools this server provides (1)

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

remember
Saves a memory, optionally linked to files.

What it does

Code-linked memories
Each memory records the files it concerns and their git hash.
Automatic staleness
Memories go stale when the linked files change.
Contradiction handling
A newer fact retires the older one it conflicts with.
Provenance
Shows which tool and session saved a memory and every change since.
Review dashboard
mnemolith ui lists memories needing a decision with file versions side by side.
AGENTS.md sync
Writes current memories into a managed section of AGENTS.md and CLAUDE.md.

Good for

  • Share project decisions between Claude Code and Cursor
  • Stop an assistant relying on outdated setup facts
  • Review what your AI remembers about a repo
  • Keep team-visible notes in AGENTS.md automatically

Pricing

Open source

Local and open source

Prices change. Check mnemolith.dev before you buy.

Mnemolith FAQ

Does it run in the cloud?

No. The site and README say it is local and runs on your machine.

Which tools does it work with?

Claude Code, Cursor and Codex, plus other MCP clients.

What was it called before?

Aether Cache; the README explains how existing memories carry over.

How is it installed?

It is published on PyPI as mnemolith.

Is Mnemolith free?

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

How do I add Mnemolith to Claude Code?

Run this command in your terminal: claude mcp add mnemolith -- uvx mnemolith

What are the best alternatives to Mnemolith?

The closest alternatives to Mnemolith are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Mnemolith

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools