ReaperMCP
An MCP server with 181 tools: an agent writes MIDI, mixes and masters tracks in REAPER without sending the project to the cloud.
- 118 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Tools edit and delete tracks, notes and effects in the open REAPER project.
Install
- Works in
Manual install
pip install xdarkzx-reaper-mcpOption C in the README: the package with the reaper-mcp command. The Lua script for REAPER has to come from the repository.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Tools edit and delete tracks, notes and effects in the open REAPER project.
This is third-party code. Review the repository files before installing.
What it does
ReaperMCP connects any MCP client to the REAPER music workstation through a file-based Lua bridge inside the program. The agent chooses notes, rhythm and controllers, builds parts, lays out vocal chops, sets up effects and sends, then measures the result. There are 181 tools in 26 modules: composition and patterns, automatic mixing and mastering with 35 genre profiles, routing, batch editing, ReaScript automation and audio QC with silence and click detection. Everything runs locally: the project, audio and MIDI never leave the computer, and no API keys are needed. The server installs from PyPI or from the repository with install.sh or install.bat, which can configure Claude Desktop itself. For other clients, add the reaper-mcp command to the MCP configuration.
Who it is for. Musicians and sound designers on REAPER who want to mix and edit a project by voice or text through an agent.
Good fit when
- A chord progression and a drum pattern need sketching directly in the project.
- Tracks are mixed for a chosen genre and then mastered with a profile.
- Many projects are checked for silence and clicks before delivery.
- Batch renaming and editing of tracks repeats again and again.
Not a fit when
- You work in another music program: the bridge targets REAPER 7 and newer.
- You want a finished song with no human involved: the server drives REAPER while the client model composes.
- The project must not be touched without a backup: tools edit and delete tracks.
Example request
Create four bars of a hip-hop drum pattern on a new track, mix it with the bass, then check clipping and silence.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
REAPER 7 or newer, Python 3.10 and the reaper_mcp_server.lua script run inside REAPER are required: the installer can add it to autostart, while a manual install means rerunning it after each program restart. The PyPI package does not include this Lua file. Tools change and delete tracks, notes and effects in the open project, so make a project copy before a session. Music quality depends on the client model.
How to disable. Remove the reaper entry from the MCP client configuration, take reaper_mcp_server.lua out of REAPER autostart and uninstall the package with pip uninstall xdarkzx-reaper-mcp.
FAQ
How do I connect ReaperMCP to Claude Code?
Install the package with `pip install xdarkzx-reaper-mcp` and add a `reaper` server with the `reaper-mcp` command to the MCP config. Then run the Lua script in REAPER.
Does the project go to the cloud?
No. REAPER and the server exchange data through a file bridge on disk, with no cloud calls or API keys.
Which clients does it work with?
Claude Desktop, Claude Code, Cursor, LM Studio and any MCP client.
Which versions are required?
REAPER 7 or newer and Python 3.10 or newer.
What do mixing and mastering cover?
Automatic mixing and mastering follow 35 genre profiles, and QC finds silence and clicks.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for REAPER: an agent creates projects, tracks and MIDI, adds effects, mixes, masters and renders a track
TwelveTake REAPER MCP gives an assistant 188 tools for mixing, mastering and MIDI in the REAPER DAW with undo for every step.
An MCP server for Ableton Live: the agent creates tracks, places clips and builds arrangements straight in the open project
The MCP server of the Audionaut editor: an agent cuts, moves, fades, analyses and exports multitrack audio projects.
MCP server for Audacity 3.x with 144 tools and 9 pipelines for audio cleanup, mastering and transcription, all processed locally.
An Ableton Live MCP server: 156 tools let Claude, Cursor or Codex write MIDI, load instruments and effects and mix a track.
README in short
The repository has a Python server, a Lua script for REAPER and installers for Windows, macOS and Linux. The tool reference is in docs/TOOLS.md and the architecture in docs/ARCHITECTURE.md. The author also ships companion projects: SongForge-MCP for music generation and Audacity-MCP for audio cleanup.