
Mnemolith
Project memory for Claude Code, Cursor and Codex that retires facts when code changes
- 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 mnemolithAdd to claude_desktop_config.json
{
"mcpServers": {
"mnemolith": {
"command": "uvx",
"args": [
"mnemolith"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mnemolith": {
"command": "uvx",
"args": [
"mnemolith"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools