# Reado

> Reado is an open-source MCP server for developer tools. Lets your coding agent read and resolve the review comments you leave in the Reado IDE. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://reado.watermelon-studio.it
- **Repository:** https://github.com/watermelonbros/reado
- **MCP Registry name:** io.github.WatermelonBros/reado
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Reado is a desktop IDE built for reading code an agent has written, and this server is how the agent sees your review. A comment is anchored to a line range, typed as bug, refactor, performance, question or note, threaded, and marked as a task for the agent or a note for the next reader. Comments are stored as plain Markdown under `.reado/` beside your code, move with it when it changes, and become orphans if their code disappears.

When you choose Send review, Reado hands the open tasks to an agent in its terminal. The agent works through the `reado` CLI and this server, reads your comments, consults the project's docs and specs, and closes each task, while the IDE shows every step. The README names Claude Code, Codex, Copilot, Gemini, OpenCode and Cursor as supported agents.

The server ships as an MCPB bundle (v1.34.0) that runs over stdio. Reado is MIT-licensed, keeps code and comments on your machine, and treats an account as optional.

## Features

- **Anchored review comments:** Typed, threaded comments tied to line ranges in plain Markdown files.
- **Task handoff:** Open comment tasks are passed to the agent, which closes each one.
- **Guided reviews:** The agent plans a route through a diff and proposes findings you approve.
- **Project docs access:** The agent can consult docs and specs while resolving tasks.
- **Local-first storage:** Code and comments stay on your machine; an account is optional.
- **Orphan handling:** Comments whose code is gone are marked orphaned instead of pointing at the wrong line.

## Good for

- Review an agent's branch by commenting on lines instead of rewriting them
- Hand a list of review tasks to Claude Code or Codex in one step
- Keep review notes in the repo for the next reader
- Run a focused review on security or test coverage with an AI pair

## Install

### Claude Code (Terminal)

```sh
claude mcp add reado -- npx -y https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "reado": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "reado": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "reado": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "reado": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "reado": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb"
      ]
    }
  }
}
```

## FAQ

### Which agents does it work with?

The README lists Claude Code, Codex, Copilot, Gemini, OpenCode and Cursor.

### Where are comments stored?

As Markdown files in a .reado folder next to your code, which you can commit.

### Is Reado free?

The site calls it free and open source under the MIT licence; a Pro tier is also mentioned, with no price published.

### Which platforms does the IDE run on?

macOS, Windows and Linux.

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

Run this command in your terminal: claude mcp add reado -- npx -y https://github.com/WatermelonBros/reado/releases/download/v1.34.0/reado.mcpb

### What are the best alternatives to Reado?

The closest alternatives to Reado 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/reado
