reaper-mcp-server 0.1.1

MCP server for controlling REAPER DAW with AI agents

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-audio/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