reaper-reapy

This MCP server provides a Python-based bridge between an instance of the REAPER DAW and AI-assisted control via the Model Context Protocol. It exposes a comprehensive set of MCP tools to manage tracks, FX, project settings, MIDI and audio items, regions, markers, and more, using REAPER through the reapy integration. You can test connections, inspect and modify track properties, manipulate MIDI and audio items, and orchestrate project playback and rendering through the MCP inspector tooling. The server supports dual position formats (time in seconds and measure:beat) for item placement and edits, enabling musically aware automation and scripting workflows. Use the included test_mcp tool to verify connectivity and experiment with commands like create_track, add_fx, set_tempo, create_midi_item, insert_audio_item, and render_project, among others. The environment is designed so you can drive REAPER from AI prompts or automated scripts via MCP messages, while preserving accurate item duplication and REAPER-native command handling for reliability.

Prerequisites:

• Python 3.7+ installed on your system
• REAPER DAW installed
• Internet connection for sample assets if needed
• Access to a terminal or command prompt

Installation steps:

1. Install the Python package that provides REAPER integration and MCP server support (either from PyPI or GitHub):

   # From PyPI
   pip install reaper_reapy_mcp
   
   # From GitHub repository
   pip install git+https://github.com/wegitor/reaper-reapy-mcp.git
   

2. Ensure REAPER is configured to allow scripting access and that the REAPER side server is enabled (per project instructions) so the Python package can control REAPER via reapy.
3. Confirm Python is available in REAPER (as described in the project docs) and that the required dependencies are installed.
4. Run the MCP server using the UV (or Python module) integration as shown in the usage guide:

   uv --directory <project_path> run -m reaper_reapy_mcp
   

   Or simply:

   python -m reaper_reapy_mcp
   

5. If you prefer direct Claude-style configuration, ensure your mcp_config aligns with the provided JSON example and points to the correct module path.

Tips and common issues:

• Ensure Python 3.7+ is installed and accessible in your system path.
• The REAPER side server must be enabled for reapy to control REAPER; follow the project’s guidance to enable reaper_side_enable_server.py.
• The dual-position format support means you can specify positions in seconds or in measure:beat notation for MIDI and audio item operations.
• For reliable duplication and item movement, REAPER’s built-in commands are used; verify that these commands are available in your REAPER install.
• If you encounter connection problems, check that the MCP inspector tool is available and that test_mcp.bat (or equivalent) runs on your platform.
• If paths or environment variables differ across OSes (Windows vs Unix-like), adjust the uv directory flag and module import path accordingly.