# MIMRY

> MIMRY is a free MCP server for developer tools. Rank the files and lines a coding task touches so an agent reads less. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://jbacalso24.github.io/mimry/
- **Repository:** https://github.com/jbacalso24/mimry
- **MCP Registry name:** io.github.jbacalso24/mimry
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Rather than listing every file that mentions a word, MIMRY ranks the few to read first and says why, such as name or path matches and connections to other hits. For a task described in plain words it returns the files plus the line ranges inside them, and writes a Markdown context pack with symbols, relationships and test commands.

It builds a deterministic index and dependency graph with tree-sitter across 41 languages, with no LLM in the indexing step. The site says code is not uploaded, there are no remote embeddings and no telemetry, and credential files are skipped. Agents can also record which files helped so similar tasks rank them higher later.

The project's own benchmark, on 44 merged pull requests from 6 open-source projects, reports 71 percent fewer tokens than keyword search, and the authors note this measures retrieval, not guaranteed savings. Install with uv tool install mimry, then connect Claude Code, Codex or another agent.

## Features

- **Ranked file lists:** Returns the files and lines to read first, with reasons.
- **Context packs:** Writes a Markdown handoff with symbols, relationships and reading order.
- **Dependency graph:** Maps imports, calls, definitions and references across 41 languages.
- **Learns from usage:** Records opened and changed files to improve later rankings.
- **Local only:** No code upload, remote embeddings or telemetry.
- **Agent installers:** Installs into Claude Code and other agents with hooks.

## Good for

- Point an agent at the right files for a bug report
- Cut tokens spent exploring a large repository
- Produce a reading order before a code change
- Diagnose why an index is stale after renames

## Install

### Claude Code (Terminal)

```sh
claude mcp add mimry -- uvx mimry
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Does my code leave my machine?

No, the site says no code upload, remote embeddings or telemetry.

### How do I install it?

Run uv tool install mimry; it needs Python 3.11 or newer.

### How good is the retrieval?

The site reports recall@5 of 0.94 on a 9-case benchmark and 71 percent fewer tokens on a scripted 44-task test.

### Which agents does it support?

Claude Code and Codex, among others via mimry install.

### Is it free?

The site calls it a free, local CLI and MCP server.

### Is MIMRY free?

Yes. MIMRY is free to use.

### How do I add MIMRY to Claude Code?

Run this command in your terminal: claude mcp add mimry -- uvx mimry

### What are the best alternatives to MIMRY?

The closest alternatives to MIMRY 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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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