# Retake

> Retake is an open-source MCP server for design and media. Re-voice one wrong sentence of a voiceover in your own voice and splice it back. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Website:** https://huggingface.co/spaces/headvox/retake
- **Repository:** https://github.com/yyert123/retake
- **MCP Registry name:** io.github.yyert123/retake
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Say "Wednesday" when you meant "Thursday" and Retake fixes only that sentence. It transcribes the take, caches the transcript, finds the sentence containing the words to replace (and refuses to guess if they appear twice), and snaps cut points to the quietest part of the surrounding pause so cuts never land inside a word.

The new sentence is generated by the Miragea voice service from a saved voice ID or a reference clip, then matched to the recording by trimming silence, matching EQ and loudness, laying room tone underneath and crossfading the seams. Output is a 24-bit WAV, a JSON edit list and a CSV of markers, so it works with editors such as Premiere, Resolve, Final Cut, Audacity or CapCut. The original file is never changed.

It is a pip package with a CLI and an MCP server, MIT licensed, and needs a Miragea API key for transcription and voice, which is billed pay-as-you-go. The README says it is early (v0.1.1), with an audio demo still to come.

## Features

- **Sentence-level fixes:** Replaces a chosen sentence rather than the whole recording.
- **Pause-aware cuts:** Places cut points at the quietest part of nearby pauses.
- **Tone matching:** Matches EQ, loudness and room tone to the original take.
- **Editor-friendly exports:** Writes a fixed WAV, JSON edit list and CSV markers.
- **Voice options:** Uses a saved voice ID or a cloned reference clip.
- **CLI and MCP:** Usable from the command line or by AI agents.

## Good for

- Fix a misspoken date in a narration
- Swap a product name in a recorded tutorial
- Patch a podcast line without re-recording
- Let an agent correct a voiceover and return markers

## Install

### Claude Code (Terminal)

```sh
claude mcp add retake --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- uvx retake-vo
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "retake": {
      "command": "uvx",
      "args": [
        "retake-vo"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "retake": {
      "command": "uvx",
      "args": [
        "retake-vo"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "retake": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "retake-vo"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "retake": {
      "command": "uvx",
      "args": [
        "retake-vo"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "retake": {
      "command": "uvx",
      "args": [
        "retake-vo"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

## FAQ

### What do I need to run it?

Install retake-vo and set a Miragea API key, which handles transcription and voice.

### Does it modify my original audio?

No, the original file is never modified.

### Which editors does it work with?

Any editor, since it outputs a WAV plus edit markers.

### How long can a fix be?

Up to 2,000 characters per fix, according to the README.

### Is Retake free?

Yes. Retake is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add retake --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- uvx retake-vo

### What are the best alternatives to Retake?

The closest alternatives to Retake are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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