# Mitos

> Mitos is an open-source MCP server for knowledge and memory. Decision memory for AI-assisted coding: records choices, rejected options and precedent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS
- **Repository:** https://github.com/dovahkiin-v/mitos
- **MCP Registry name:** io.github.dovahkiin-v/mitos
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mitos -- uvx mitos-adr
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mitos": {
      "command": "uvx",
      "args": [
        "mitos-adr"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mitos": {
      "command": "uvx",
      "args": [
        "mitos-adr"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mitos": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mitos-adr"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mitos": {
      "command": "uvx",
      "args": [
        "mitos-adr"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mitos": {
      "command": "uvx",
      "args": [
        "mitos-adr"
      ]
    }
  }
}
```

## Tools

- `surface_decisions`: Find precedent before deciding
- `record_decision`: Record a settled decision and its relations
- `query_decisions`: Search decisions by meaning or exact handle

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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