Mitos
Decision memory for AI-assisted coding: records choices, rejected options and precedent
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.20.0
- Listing updated
- today
Similar MCP servers
About Mitos
Mitos is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Over months of building with AI assistants, the reasoning behind decisions gets lost and assistants re-suggest options you already ruled out. Mitos records each decision, the alternatives you rejected, and how later decisions supersede or amend earlier ones, then gives that history back to the assistant in compact form. The README says one month of intensive design reviews produced close to 900 decision records in one markdown file.
The markdown file (decisions.md plus quarterly archives) is the source of truth and can always be read and grepped. A typed graph in SQLite and a local Qdrant index sit on top and can be rebuilt from it. Three verbs carry the loop: surface precedent before deciding, record a decision when it is settled, and query by meaning or by exact handle. If search or the embedding API is down, recording still works and search falls back to text matching. A corpus check finds decisions that contradict each other, and a git commit gate can hold commits until a check has run.
Setup needs pipx, a Docker Qdrant container on port 7333, and a Gemini API key for embeddings (an Anthropic key is recommended for the conflict audit). It is marked an early release.
Install
Run in a terminal
claude mcp add mitos -- uvx mitos-adrAdd to claude_desktop_config.json
{
"mcpServers": {
"mitos": {
"command": "uvx",
"args": [
"mitos-adr"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mitos": {
"command": "uvx",
"args": [
"mitos-adr"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mitos": {
"type": "stdio",
"command": "uvx",
"args": [
"mitos-adr"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mitos": {
"command": "uvx",
"args": [
"mitos-adr"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mitos": {
"command": "uvx",
"args": [
"mitos-adr"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- surface_decisions
- Find precedent before deciding
- record_decision
- Record a settled decision and its relations
- query_decisions
- Search decisions by meaning or exact handle
What it does
- Decision records
- Stores each decision with rejected alternatives and relations to earlier ones.
- Precedent surfacing
- Shows relevant past decisions and why options were rejected before a new choice.
- Markdown source of truth
- Keeps human-readable files from which the graph and index can be rebuilt.
- Supersede, not edit
- Changes decisions through later ones, so the history of why survives.
- Contradiction audit
- Sweeps the record for decisions that silently conflict.
- Commit gate
- Optional git hook holds commits until a check has been attempted.
Good for
- Stop an assistant re-proposing an option you already rejected
- Look up why an architecture choice was made months ago
- Record a settled decision with its alternatives mid-session
- Audit a decision log for contradictions before release
Pricing
Open source
Free; you supply your own Gemini key
Mitos FAQ
What do I need to run it?
pipx, a local Qdrant container on port 7333, and a Gemini API key; an Anthropic key is recommended for the conflict audit.
Where are decisions stored?
In a human-readable decisions.md with quarterly archives; the graph and search index are derived from it.
What happens if the search index is down?
Recording still works and search falls back to text matching over the markdown.
Is it production ready?
The README labels it an early release under active development.
Is Mitos free?
Yes. Mitos is open source, so you can use and self-host it for free.
How do I add Mitos to Claude Code?
Run this command in your terminal: claude mcp add mitos -- uvx mitos-adr
What are the best alternatives to Mitos?
The closest alternatives to Mitos are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


