Mnemolith — Claude Code MCP server: what it does, how to install
Mnemolith is a Claude Code MCP server that maintains shared local memory linked to git file hashes. Runs during context retrieval and fact storage across coding sessions.
MIT ★ 6 updated 2026-11-17
claude mcp add mnemolith -- uvx mnemolithWhat Mnemolith does
The server stores project knowledge across coding tools and automatically detects obsolete entries using git tree hashes. When a tracked file changes, linked memories become inactive until manually reconfirmed or replaced with updated facts. Conflicting statements overwrite older records, and repeated items merge automatically.
Underneath, a Python layer manages text embeddings and git hashing, while a custom RESP-compatible Java engine handles storage, HNSW vector indexing, and append-only disk logging. Active entries sync directly into managed sections of AGENTS.md and CLAUDE.md, while repository-wide items commit into mnemolith.md.
Running the server requires uvx or a local Python environment with the mnemolith PyPI package. An integrated web dashboard starts via mnemolith ui to inspect file diffs alongside stale memories.
What it helps with
- preserve technical context and architectural rules across agent sessions
- invalidate stale instructions when associated repository files change
- synchronize shared codebase rules between team members via git
Example prompts for the agent
- Remember that the API runs via docker compose linked to docker-compose.yml
- Recall the database connection rules for local development
- Explain provenance and change history for memory m1
How to install Mnemolith
Platform CLI
claude mcp add mnemolith -- uvx mnemolithuvx runs the command named after the package; if the README names another one, use uvx --from mnemolith <command>
Platform CLI
codex mcp add mnemolith -- uvx mnemolithuvx runs the command named after the package; if the README names another one, use uvx --from mnemolith <command>
Config file
{
"mcpServers": {
"mnemolith": {
"command": "uvx",
"args": [
"mnemolith"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mnemolith <command>
Config file
{
"servers": {
"mnemolith": {
"type": "stdio",
"command": "uvx",
"args": [
"mnemolith"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mnemolith <command>
Platform CLI
gemini mcp add mnemolith uvx mnemolithuvx runs the command named after the package; if the README names another one, use uvx --from mnemolith <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Mnemolith
How to install Mnemolith in Claude Code?
Run claude mcp add mnemolith -- uvx mnemolith in your terminal.
What does Mnemolith do?
It provides a shared memory layer for AI coding assistants that automatically tracks file revisions in git and flags outdated facts.
What is required to run Mnemolith?
You need uvx installed (or the mnemolith package from PyPI) to launch the server locally.