# Mnemolith

> Mnemolith is an open-source MCP server for knowledge and memory. Project memory for Claude Code, Cursor and Codex that retires facts when code changes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://mnemolith.dev
- **Repository:** https://github.com/anishchugh05/mnemolith
- **MCP Registry name:** io.github.anishchugh05/mnemolith
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mnemolith -- uvx mnemolith
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `remember`: Saves a memory, optionally linked to files.

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mnemolith
