reaper-mcp

# 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](https://www.reaper.fm/) DAW installed and running - Python 3.10+ - REAPER's distant API enabled (see [Setup](#setting-up-reaper)) ## Installation ```bash pip install reaper-mcp-server ``` Or install from source: ```bash 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](https://github.com/RomeoDespres/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) ```python import reapy reapy.config.enable_dist_api() ``` 4. Restart REAPER ## Usage ### With Claude Desktop Add to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "reaper": { "command": "reaper-mcp-server", "args": [] } } } ``` ### With Claude Code ```bash claude mcp add reaper -- reaper-mcp-server ``` ### Standalone ```bash 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