Re-voices specific sentences in an audio recording using a cloned voice and splices them back with matched loudness, tone, and room tone.
Also known as yyert123/retake, retake-vo
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 251
- Latest version
- 0.1.1
- Last commit
- Nov 8, 2026
- License
- MIT
What is Retake MCP?
Retake is an MCP server. Re-voices specific sentences in an audio recording using a cloned voice and splices them back with matched loudness, tone, and room tone.
Summary generated from the project's README
About Retake MCP server
Fixing voiceover mistakes in audio recordings without re-recording is what Retake enables for editors and creators. By using a cloned voice, this tool re-voices specific sentences and splices them back into the original file with matched loudness, tone, and room tone. It works with any video editor like Premiere, Resolve, or Final Cut by providing a fixed WAV file alongside edit markers and a JSON edit list.
Users can run this via a command line interface or connect it to AI agents through an MCP server setup. To function, the server requires a Miragea API key and ffmpeg installed on the system. It uses Miragea for speech recognition and voice generation, allowing you to use saved voice IDs or reference clips to ensure the new audio sounds like the original speaker. The process includes automatic transcription, finding real cut points at quiet pauses, and applying equal-power crossfades to hide the edits.
What you can do with it
- 1Correct a spoken word errorChange a specific word in an audio file, such as replacing 'Wednesday' with 'Thursday', using a specific voice ID.
- 2Rewrite an entire sentenceReplace a whole line of dialogue by referencing its line number from a previous transcription.
- 3Automate audio editing via AIInstruct an AI agent to find and fix a mistake in a video file located in a local directory.
Written from the project's README. Every use case is checked against a quote from it.
How to install Retake MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Retake MCP in Claude Code
$ claude mcp add --env 'MIRAGEA_API_KEY=<YOUR_MIRAGEA_API_KEY>' retake -- uvx retake-voInstall Retake MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"retake": {
"command": "uvx",
"args": [
"retake-vo"
],
"env": {
"MIRAGEA_API_KEY": "<YOUR_MIRAGEA_API_KEY>"
}
}
}
}Install Retake MCP in VS Code
.vscode/mcp.json
{
"servers": {
"retake": {
"type": "stdio",
"command": "uvx",
"args": [
"retake-vo"
],
"env": {
"MIRAGEA_API_KEY": "<YOUR_MIRAGEA_API_KEY>"
}
}
}
}Install Retake MCP in VS Code CLI
$ code --add-mcp '{"name":"retake","type":"stdio","command":"uvx","args":["retake-vo"],"env":{"MIRAGEA_API_KEY":"<YOUR_MIRAGEA_API_KEY>"}}'Install Retake MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"retake": {
"command": "uvx",
"args": [
"retake-vo"
],
"env": {
"MIRAGEA_API_KEY": "<YOUR_MIRAGEA_API_KEY>"
}
}
}
}Install Retake MCP in Codex
$ codex mcp add retake --env 'MIRAGEA_API_KEY=<YOUR_MIRAGEA_API_KEY>' -- uvx retake-voInstall Retake MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.retake] command = "uvx" args = ["retake-vo"] [mcp_servers.retake.env] MIRAGEA_API_KEY = "<YOUR_MIRAGEA_API_KEY>"
Install Retake MCP in Gemini CLI
$ gemini mcp add -s user -e 'MIRAGEA_API_KEY=<YOUR_MIRAGEA_API_KEY>' retake uvx -- retake-voInstall Retake MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"retake": {
"command": "uvx",
"args": [
"retake-vo"
],
"env": {
"MIRAGEA_API_KEY": "<YOUR_MIRAGEA_API_KEY>"
}
}
}
}Configuration
MIRAGEA_API_KEYRequiredSecretMiragea API key (https://miragea.ai), used for transcription and voice
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableyyert123/retake is public and reachablegithub.com/yyert123/retake ↗Pass
- Package names this repository as its sourceretake-vo names yyert123/retake as sourcepypi.org/project/retake-vo/ ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/yyert123/retake ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from retake-voPass
- No critical advisory in the package or its dependencies30 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubRetake: fix a voiceover mistake in your own voice (open-source Overdub alternative)
Said "Wednesday" instead of "Thursday"? Don't re-record. Retake re-voices only the sentence you changed, in the same voice, and splices it back into your recording with matched loudness, tone (EQ) and room tone. Works with any editor (Premiere, Resolve, Final Cut, Audacity, CapCut) because it simply gives you a fixed WAV plus edit markers. CLI for humans, MCP server for AI agents. Voice engine: Miragea.
pip install retake-vo
export MIRAGEA_API_KEY=your_key # https://miragea.ai
retake transcribe take.wav # numbered sentences + timestamps (cached, pay once)
retake fix take.wav --replace "Wednesday" --with "Thursday" --voice YOUR_VOICE_ID
# -> take.fixed.wav, take.fixed.edits.json, take.fixed.markers.csv
Status (v0.1.1, 2026-11-08): transcription, sentence finding, pause-snapped cut points, EQ/loudness/ room-tone matching, splicing, exports, CLI and MCP server are tested (9 offline tests + live Miragea transcription on real recordings). A listen-to-it before/after demo will be added to the demo page as soon as the voice side is verified end to end.
What it does automatically
- Transcribes the take with Miragea speech recognition and splits it into sentences (initials like "O. Henry" handled). The transcript is cached next to the file, so later fixes cost nothing extra.
- Finds the sentence that contains your words; refuses to guess if they appear twice.
- Finds real cut points: sentence edges are snapped to the quietest stretch of the pause around them, so cuts never land inside a word, even though recognition segments can split words.
- Re-voices the edited sentence with Miragea in your saved voice, or cloned from a reference clip.
- Matches it to the take: trims silence, matches the long-term spectrum (EQ, 1/3-octave smoothed, clamped), matches speech loudness, lays your own room tone under it, equal-power crossfades the seams.
- Exports a 24-bit WAV at the original sample rate and channels, a JSON edit list (old/new text, old/new times, gain), and a CSV of markers you can import into your editor. The original file is never modified.
Why Retake (honest comparison)
| Retake | Descript Overdub / Regenerate | DaVinci Resolve 21 Speech Generator | Reasonate (REAPER) | Manual ElevenLabs workflow | |
|---|---|---|---|---|---|
| Price | Free, MIT; pay-as-you-go voice | Subscription | Resolve Studio ($295) | Free + ElevenLabs plan | ElevenLabs plan |
| Works with your editor | Any (WAV + markers) | Only inside Descript | Only inside Resolve | Only inside REAPER | Any, by hand |
| Finds the line for you | Yes, by words or line number | Yes | No, you place it | Yes (forced alignment) | No |
| Cut points at real pauses | Automatic | Automatic | Manual | Automatic | Manual |
| Loudness match | Automatic | Automatic | Manual | Automatic | Manual |
| EQ / tone match | Automatic | Partial | Manual | No | Manual (the most-cited pain) |
| Room tone under patch | Automatic | Partial | No | No | Manual |
| Length per fix | Up to 2,000 characters | - | ~350 characters | - | - |
| AI agents (MCP) | Yes, retake-mcp |
No | No | No | No |
| Voice engine | Miragea (saved voice or clone) | Descript | Resolve built-in voices / custom WAV | ElevenLabs only | ElevenLabs |
Sources: Resolve limits per davinciresolveclub.com; Reasonate per its README; the EQ-matching pain per an r/editors thread.
Choosing the voice
| Option | When | Example |
|---|---|---|
--voice ID |
You saved your voice in your Miragea account (best: consistent, no upload) | --voice v_abc123 |
--ref-url URL --ref-text "..." |
You have a public clip of the same speaker; giving its exact words uses the cheaper 1x rate | --ref-url https://raw.githubusercontent.com/you/voice/main/me.wav |
--host hf:user/repo |
Fully automatic: Retake cuts ~9 s of untouched speech from the take and uploads it to your public Hugging Face dataset (needs pip install "retake-vo[hf]" and HF_TOKEN) |
--host hf:me/voice-refs |
Reference URLs must be public, served directly (no long signed redirects) and under 1,024 characters. Miragea has agreed to add a direct upload endpoint; when it ships, Retake will upload the clip from your take itself and these options become optional.
More examples
# several fixes in one pass (each sentence re-voiced once)
retake fix vo.mp3 --replace "twenty twenty-five" --with "twenty twenty-six" --replace "Jon" --with "John" --voice v1
# rewrite a whole sentence by its number from `retake transcribe`
retake fix vo.wav --line 7 --say "Click Export, then choose MP4." --voice v1 -o vo.v2.wav
# keep each generated patch as its own file (for manual placement in a DAW)
retake fix vo.wav --replace "fourty" --with "forty" --voice v1 --keep-patches
Use it from Claude, Cursor or Codex (MCP)
No install step needed with uv:
{ "mcpServers": { "retake": { "command": "uvx", "args": ["retake-vo"], "env": { "MIRAGEA_API_KEY": "your_key" } } } }
Or pip install retake-vo and use "command": "retake-mcp".
Then ask: "In ~/Videos/launch/vo.wav, change 'Wednesday' to 'Thursday' using my voice v_abc123."
Tools: transcribe_take(path) and fix_line(path, old_words, new_words | line, new_sentence, voice_id | ref_url | host).
Python API
from retake import fix, transcribe
lines = transcribe("take.wav")["sentences"]
res = fix("take.wav", [("Wednesday", "Thursday")], voice="v_abc123")
print(res.output, res.edits[0].new_start)
FAQ
Will people hear the patch? Retake does everything an editor would do by hand: cut in the pause, match level, tone and room noise, crossfade. Quality still depends on the clone; a saved Miragea voice made from a clean 10-20 s sample of the same mic gives the closest match. Listen before you publish.
Does it change the rest of my audio? No. Everything outside the edited sentences is copied sample for sample; later audio shifts by the length difference, which the edit list and markers report.
What does it cost? Transcription: 3 Miragea points per second of audio, once per file (cached). Each fix: Miragea's per-character rate for the new sentence (1x with a saved voice or exact reference text).
Is my key safe? It is read from MIRAGEA_API_KEY only, never logged or written to disk.
Can I fix someone else's recording? Only with the speaker's consent. Retake is built for fixing your own narration or a talent's read you are licensed to edit.
Which formats? Anything ffmpeg reads (WAV, MP3, M4A, FLAC, MP4, MOV...). Output is WAV by default; use
-o fixed.mp3 for MP3.
Error messages? Every error says what went wrong and how to fix it (missing key, ffmpeg not installed, word not found, word found twice, balance, rate limit). Re-running is always safe.
Requirements
Python 3.9+, ffmpeg on PATH, a Miragea API key.
Related
- miragea-skills: Agent Skills for captions and Remotion narration.
- HeadVox: script to voiceover with word-aligned captions.
MIT License.
Retake MCP questions
How do I add Retake MCP to Claude Code?
Run claude mcp add --env 'MIRAGEA_API_KEY=<YOUR_MIRAGEA_API_KEY>' retake -- uvx retake-vo in your terminal. Add --scope user to make it available in every project.
How do I add Retake MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Will people hear the patch?
Retake matches level, tone, room noise, and uses crossfades to make the edit sound natural, though quality depends on the voice clone.
Does it change the rest of my audio?
No, audio outside the edited sentences is copied sample for sample, though later audio may shift due to length differences.
What formats are supported?
It supports any format that ffmpeg can read, including WAV, MP3, M4A, FLAC, MP4, and MOV.
Is my API key safe?
Yes, the key is only read from the MIRAGEA_API_KEY environment variable and is never logged or written to disk.