Skip to content
MCP server

Mitos

Decision memory for AI-assisted coding: records choices, rejected options and precedent

Runs locallyStatus and history
Install
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-adr

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

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.

How AIPoweredBot checks servers