reaper-mcp

MCP.Pizza Chef: bonfire-systems

Fifty-eight tools cover a whole session: creating projects and tracks, writing drum patterns and chord progressions, adding effects, setting volume and panning, and exporting the final mix or separate stems. The measurements are real, not guessed — loudness, dynamics, clipping, stereo width and frequency balance are all calculated from an actual render of your project. REAPER itself is paid software with a free evaluation, has to be running with its remote scripting switched on, and installing this takes a command line. No account or key.

Other

Use This MCP server To

Sketch a drum pattern and a chord progression for a demo Balance the levels across every track in my session Export separate stems to send to a collaborator Check whether my mix is loud enough for streaming Find out if the master is clipping before I upload Drop a mastering chain onto the master track

README

REAPER MCP Server

A Model Context Protocol (MCP) server that enables AI agents to control REAPER DAW — 58 tools covering project management, tracks, MIDI, FX, mixing, mastering, rendering, and audio analysis.

Requirements

  • REAPER DAW installed and running
  • Python 3.10+
  • REAPER's distant API enabled (see Setup)

Installation

pip install reaper-mcp-server

Or install from source:

git clone https://github.com/bonfire-systems/reaper-mcp.git
cd reaper-mcp
pip install -e .

Setting Up REAPER

The server communicates with REAPER via python-reapy, which requires REAPER's distant API to be enabled.

  1. Open REAPER
  2. Go to Actions > Run ReaScript
  3. Select scripts/enable_reapy.py from this repo (or create a new script with the contents below)
    import reapy
    reapy.config.enable_dist_api()
  4. Restart REAPER

Usage

With Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "reaper": {
      "command": "reaper-mcp-server",
      "args": []
    }
  }
}

With Claude Code

claude mcp add reaper -- reaper-mcp-server

Standalone

reaper-mcp-server          # start the server
reaper-mcp-server --debug  # with debug logging

Tools (58)

Project Management

create_project load_project save_project get_project_info set_tempo set_time_signature set_cursor_position play_project stop_transport

Tracks

create_track delete_track rename_track list_tracks get_track_info set_track_color create_bus create_send remove_send list_sends

MIDI

create_midi_item add_midi_note create_chord_progression create_drum_pattern

FX & Instruments

add_fx remove_fx bypass_fx list_track_fx get_fx_parameters set_fx_parameter load_fx_preset add_master_fx list_master_fx set_master_fx_parameter

Audio

import_audio_file edit_audio_item start_recording adjust_pitch adjust_playback_rate

Mixing

set_track_volume set_track_pan set_track_mute set_track_solo set_send_volume set_master_volume add_volume_automation add_pan_automation

Rendering

render_project render_stems render_time_selection

Mastering

apply_mastering_chain apply_limiter normalize_project

Analysis

analyze_loudness analyze_dynamics analyze_frequency_spectrum analyze_stereo_field analyze_transients detect_clipping

Configuration

The server stores its configuration in your platform's config directory:

  • macOS: ~/Library/Application Support/reaper-mcp/config.json
  • Linux: ~/.config/reaper-mcp/config.json
  • Windows: %APPDATA%\reaper-mcp\config.json

License

MIT

reaper-mcp FAQ

Do I need to pay for anything?
The server is free and needs no account or key, but REAPER itself is paid software. It offers a full-featured evaluation period first.
Can I use this to get a track ready for streaming?
Yes. It measures the loudness of a real render and can move the master volume to hit the usual streaming target.
Does it make up the numbers it reports?
No. Loudness, clipping, stereo and frequency readings are all measured from an actual bounce of your project using proper audio maths.
Do the limiter settings I ask for actually take effect?
No. The limiter tool accepts a threshold and a release time and then ignores both, adding the plug-in at its own defaults instead.
How hard is the setup?
Harder than most. You install it with a Python command, run a small script once inside REAPER to open its remote scripting, then restart REAPER.
Which apps does it work in?
Claude Desktop and Claude Code are documented, and the same command works in other desktop assistants that accept one.
Can it wreck my project?
It deletes tracks immediately with no confirmation and can save over your project in one request, so keep a backup of anything you care about.
Is it maintained?
Yes. It was last updated in June 2026 and is MIT licensed, though the authors still label it early-stage.