reaper

This MCP server enables AI agents to control REAPER and perform end-to-end project workflows, including creating projects and tracks, adding MIDI notes, routing, mastering, and basic analysis feedback. The server supports two primary modes: OSC for lightweight, network-based control and ReaScript-based mode for deeper REAPER automation when Python scripting is available. Start the server using the recommended entry point (the Python module reaper_mcp) and then interact with the MCP tools exposed by the server. You can select the desired mode at startup and configure OSC host/ports as needed. The included MCP tools provide essential abilities such as create_project, create_track, list_tracks, add_midi_note, and get_project_info, enabling automated or agent-driven composition and mixing workflows.

Prerequisites:

• REAPER DAW installed
• Python 3.8+ (recommended)
• OSC support enabled in REAPER (for OSC mode) and ReaScript API available if using ReaScript mode

Install steps:

1. Clone the repository and navigate into it: git clone https://github.com/itsuzef/reaper-mcp.git cd reaper-mcp

2. Create and activate a virtual environment: python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

3. Install the package in editable mode: pip install -e .

4. Run the server (module-based entry point): python -m reaper_mcp

Note: If you need OSC or ReaScript mode toggles, configure them via the provided startup scripts or command-line options as described in the README. Windows users can rely on the provided scripts in scripts/ for starting the server.

Tips and common issues:

• If you experience ReaScript API issues, switching to OSC mode is recommended since it does not rely on ReaScript being fully functional.
• Ensure REAPER is configured correctly for OSC: device name, local ports, and IP address must match server settings.
• When using Windows, you may need to adjust PowerShell execution policies or run the provided batch/PowerShell scripts to start the server.
• If firewall rules block OSC traffic, add exceptions for Python and REAPER.
• For OSC debugging, enable debug logging on startup to see port activity and message routing.
• The MCP tools exposed by the server (create_project, create_track, list_tracks, add_midi_note, get_project_info) are designed for automation and agent-driven workflows; you can extend them with additional commands as needed.