ReaMCP
Enables comprehensive MIDI manipulation in REAPER, allowing for the creation of MIDI items, batch-editing of notes, and management of CC, pitch-bend, and program-change events.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ReaMCP Create a new track named 'Vocals' and set the project tempo to 120 BPM"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ReaMCP
ReaMCP is a Reaper MCP for controlling and editing projects in your DAW. Connect this to agentic editors like Claude Desktop, VS Code or Zed to make use of the querying and editing tools in Reaper.
This project is currently in its alpha stage. Keep a backup your projects and report any issues you find. This is tested using Linux but I'd like to make it compatible with all operating systems.
How this differs from similar projects
There are a few other REAPER MCP servers. Here's how they compare:
dschuler36/reaper-mcp-server — Read-only, file-based. Parses .rpp project files directly from disk and does audio analysis on rendered files. No live REAPER connection — REAPER doesn't need to be open. Good for querying existing projects and mix feedback, but can't create or change anything.
itsuzef/reaper-mcp — Live connection via OSC or ReaPy (Python-in-REAPER). OSC is limited to transport and basic fader control; the ReaScript mode is more capable but requires configuring Python inside REAPER. Only a handful of tools (create track, add MIDI note, get project info).
This project — Live connection via a persistent Lua bridge script running inside REAPER, communicating over a local TCP socket. No OSC setup, no Python DLL wiring. Exposes the full reaper.* Lua API surface, giving a much broader and more reliable toolset: full MIDI editing, FX chain management, automation, sends, markers, media item manipulation, and more.
Related MCP server: flemcee
What it does
Read project and track state
Create, duplicate, and delete tracks and media items
Move and resize media items on the timeline
Create MIDI items; read, insert, modify, and delete MIDI notes, CC, pitch bend, and program change events; batch-edit and humanize notes
Insert audio files onto tracks
Control transport and cursor position
Add, list, and remove FX (including on the master track); read/write FX parameters; bypass/enable FX; load presets by name with case-insensitive fallback enumeration
Read and set tempo/time signature and project parameters
Save the project and trigger undo
Add, list, and delete markers and regions
Open project files by path
Create, remove, and adjust track sends (volume and pan)
Set track recording input and input monitoring mode
Read and insert automation envelope points; clear envelopes; insert beat-aligned points
Copy and repeat time ranges (duplicate chorus, extend outro, etc.)
Render a time range to an audio file
Measure loudness (LUFS integrated, short-term, momentary, true peak) for individual tracks or the master mix via non-destructive dry-run render
Normalize track volume to a target LUFS level in one call
Requirements
REAPER (with ReaPack)
Python 3.10+
Setup
1) Install the Python server
pip install -e . # You can also `uv sync` but it's not supported.2) Install mavriq-lua-sockets in REAPER and restart
REAPER's embedded Lua cannot load stock LuaSocket builds in this context. Install mavriq-lua-sockets via ReaPack:
REAPER → Extensions → ReaPack → Import repositories
Add
https://github.com/mavriq-dev/public-reascripts/raw/master/index.xmlREAPER → Extensions → ReaPack → Browse packages
Install mavriq-lua-sockets
Restart REAPER
3) Install and run the bridge script via ReaPack
REAPER → Extensions → ReaPack → Import repositories
Add
https://github.com/danielkinahan/ReaMCP/raw/main/index.xmlREAPER → Extensions → ReaPack → Browse packages
Install ReaMCP Bridge
Run it once via Actions → Show action list → ReaMCP Bridge
Confirm REAPER console shows
Listening on 127.0.0.1:9001Optional: add it to startup actions so it auto-runs on launch
You may also run this manually via Actions -> ReaScript: Run ReaScript (EEL2 or Lua)... and selecting the lua script from this repo.
4) Start the MCP server
python -m reaper_mcpOptional environment variables:
Variable | Default | Description |
|
| Bridge host |
|
| Bridge port |
MCP tools
Tool | Description |
| Verify bridge is reachable |
| Project metadata/state |
| Loop range, cursor, loop-enabled |
| Save the current project to disk |
| Trigger REAPER undo |
| Open a |
| List all tracks |
| Get one track by 0-based index |
| Insert a track |
| Delete a track |
| Duplicate a track (inserts copy after original) |
| Set name/volume/pan/mute/solo/arm |
| Set recording input (audio channel or MIDI) |
| Set input monitoring mode (off/on/not when playing) |
| Move a media item to a new timeline position |
| Change the length of a media item |
| Remove a media item from a track |
| Get position, length, pitch, playrate, etc. of an item |
| Duplicate a media item on its track |
| Create a MIDI item with optional pre-populated notes |
| Read all MIDI notes from a MIDI item |
| Modify an existing MIDI note (pitch, velocity, position, etc.) |
| Delete a MIDI note by index |
| Insert a CC, pitch-bend, or program-change event |
| Insert an audio file at a time position |
|
|
| Add FX/instrument to a track |
| List FX chain entries on a track |
| List all installed FX plugins; optional |
| List all FX parameters |
| Set FX parameter (normalized |
| Enable or bypass an FX plugin |
| Remove an FX from the chain |
| Load a named FX preset; falls back to index-scan with case-insensitive matching. Use |
| List factory and file-based presets for a plugin already on a track |
| Read BPM and time signature |
| Set BPM and optional time signature |
| Set |
| Add a marker or region |
| List all markers and regions |
| Delete a marker or region by enum index |
| Create a send from one track to another |
| Remove a track send |
| Set send volume and pan |
| Read all automation envelope points |
| Insert an automation envelope point |
| Remove all points from an envelope |
| Insert an automation point aligned to a musical beat position |
| List all media items on a track with position, length, and take info |
| Batch-edit multiple MIDI notes in one call |
| Humanize all notes in a MIDI item with random timing and velocity offsets |
| Copy all items in a time range and paste them N times after the selection |
| Render a time range to an audio file using REAPER's render pipeline |
| Measure integrated loudness (LUFS), short-term/momentary max, and true peak for a single track via non-destructive dry-run render |
| Same as above but for the full master mix |
| Measure track loudness and adjust the fader to hit a target LUFS level (default -14 LUFS) |
Limitations
Preset loading — set_fx_preset first tries TrackFX_SetPreset (works for plugins with a standard VST/CLAP program bank), then falls back to enumerating all presets by index with case-insensitive name matching via TrackFX_SetPresetByIndex. This covers most plugins. File-based presets (.ffp, .fxp) can be loaded by passing the absolute file path as preset_name. Use list_fx_presets to discover available factory and file presets.
MCP client configuration
VS Code (.vscode/mcp.json)
{
"servers": {
"reaper": {
"type": "stdio",
"command": "./.venv/bin/python",
"args": ["-m", "reaper_mcp"]
}
}
}Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"reaper": {
"command": "/path/to/venv/bin/python",
"args": ["-m", "reaper_mcp"]
}
}
}Config file location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Zed (~/.config/zed/settings.json)
{
"context_servers": {
"reaper": {
"command": {
"path": "./.venv/bin/python",
"args": ["-m", "reaper_mcp"]
}
}
}
}ReaPack package in this repo
index.xml ships the bridge script (bridge/reaper_mcp_bridge.lua) as a ReaPack package so users can install and auto-update it directly from REAPER.
Architecture
MCP client (AI / IDE)
│ stdio
▼
Python MCP server ──── JSON-RPC over TCP (127.0.0.1:9001) ────► bridge/reaper_mcp_bridge.lua
(src/reaper_mcp/) └─ reaper.* Lua API (inside REAPER)The Python process is a standard mcp server. REAPER control happens through a persistent Lua bridge script running inside REAPER.
Available Tools
57 toolsadd_fxA
Add an FX plugin to a track.
track_index: 0-based track index, or -1 for the master track
fx_name: any string REAPER's FX browser accepts ("ReaComp", "VST: Serum", etc.)
input_fx: True to add to the input FX chain
Inputs: track_index (required), fx_name (required), input_fx. Returns: object
add_markerA
Add a marker or region to the project.
position: time in seconds
is_region: True to create a region; also requires region_end
region_end: end time in seconds (only for regions)
color: REAPER color integer (0 = default)
Inputs: position (required), name, is_region, region_end, +1 more. Returns: object
analyze_master_loudnessA
Measure the loudness of the full master mix over a time range using a non-destructive dry-run render (action 42441). No tracks or files are created. Returns:
lufs_i: integrated loudness in LUFS
lufs_s_max: maximum short-term loudness in LUFS
lufs_m_max: maximum momentary loudness in LUFS
true_peak_db: true peak in dBTP
raw_stats: raw key=value string from REAPER for any additional fields
Inputs: start_time (required), end_time (required). Returns: object
analyze_track_loudnessA
Measure the loudness of a single track over a time range using a non-destructive dry-run render (action 42439). No items, tracks, or files are created — project state is completely unchanged after the call. Returns:
lufs_i: integrated loudness in LUFS
lufs_s_max: maximum short-term loudness in LUFS
lufs_m_max: maximum momentary loudness in LUFS
true_peak_db: true peak in dBTP
raw_stats: raw key=value string from REAPER for any additional fields
Inputs: track_index (required), start_time (required), end_time (required). Returns: object
clear_envelope_pointsA
Delete all automation envelope points in the given time range (default: entire timeline). Identify the envelope by name (e.g. 'Volume', 'Pan') or by 0-based envelope_index.
Inputs: track_index (required), envelope_index, envelope_name, t1, +1 more. Returns: object
create_midi_itemA
Create a MIDI item on a track and optionally pre-populate it with notes.
start / end: time in seconds
notes: list of {start_ppq, end_ppq, pitch, velocity=100, channel=0}
Inputs: track_index (required), start (required), end (required), notes. Returns: object
create_trackB
Insert a new track.
name: track name (default "Track N")
index: 0-based position (default: append at end)
Inputs: name, index. Returns: object
create_track_sendB
Create a send from one track to another. Returns the new send index.
Inputs: src_track_index (required), dst_track_index (required). Returns: object
delete_markerA
Delete a marker or region by its 0-based enumeration index (from list_markers).
Inputs: enum_index (required). Returns: object
delete_media_itemC
Delete a media item from a track.
Inputs: track_index (required), item_index (required). Returns: object
delete_midi_noteB
Delete a specific MIDI note from a MIDI item by its 0-based note index.
Inputs: track_index (required), item_index (required), note_index (required). Returns: object
delete_trackA
Delete a track by 0-based index. This is permanent and undoable via REAPER's undo system.
Inputs: track_index (required). Returns: object
duplicate_itemC
Duplicate a media item on its track.
Inputs: track_index (required), item_index (required). Returns: object
duplicate_time_rangeA
Copy all items overlapping [start_time, end_time) and paste them immediately after end_time, repeating repeat_count times. Useful for extending song form (repeating a chorus, creating an outro).
start_time / end_time: seconds
repeat_count: how many copies to paste (default 1) Returns the new project end time after pasting.
Inputs: start_time (required), end_time (required), repeat_count. Returns: object
duplicate_trackA
Duplicate a track, inserting the copy immediately after the original.
Inputs: track_index (required). Returns: object
get_envelope_pointsA
Read all automation envelope points from a track envelope. Identify the envelope by name (e.g. 'Volume', 'Pan', 'Mute') or by 0-based envelope_index. Using envelope_name is preferred and works even if the envelope is not yet visible/armed in the REAPER UI. Returns envelope name and list of points with time, value, shape, tension.
Inputs: track_index (required), envelope_index, envelope_name. Returns: object
get_fx_paramsA
Return all parameters for an FX plugin on a track. Each entry includes: param_index, name, value, min_value, max_value, normalized.
Inputs: track_index (required), fx_index (required). Returns: object
get_item_propertiesB
Return properties of a media item: position, length, mute, lock, take name, playrate, and pitch.
Inputs: track_index (required), item_index (required). Returns: object
get_midi_notesA
Read all MIDI notes from a media item's active MIDI take. Returns a list of notes with start_ppq, end_ppq, pitch, velocity, channel.
Inputs: track_index (required), item_index (required). Returns: object
get_project_infoA
Return metadata about the currently open REAPER project.
Inputs: no named parameters. Returns: object
get_project_parametersA
Return loop range, cursor position, and loop-enabled state.
Inputs: no named parameters. Returns: object
get_tempoA
Return the current BPM and time signature.
Inputs: no named parameters. Returns: object
get_trackC
Get detailed info for a single track by 0-based index.
Inputs: track_index (required). Returns: object
get_track_itemsB
List all media items on a track with their position, length, and take info.
Inputs: track_index (required). Returns: object
insert_audio_fileC
Insert an audio file onto a track at the given position (seconds).
Inputs: track_index (required), file_path (required), position (required). Returns: object
insert_envelope_pointA
Insert a point into an automation envelope. Identify the envelope by name (e.g. 'Volume', 'Pan', 'Mute') or by 0-based envelope_index. Using envelope_name is preferred and works even if the envelope is not yet visible/armed in the REAPER UI.
time: position in seconds
value: linear amplitude (Volume: 0.0=silence, 1.0=0 dB, 2.0=+6 dB max)
shape: 0=linear, 1=square, 2=slow start/end, 3=fast start, 4=fast end, 5=bezier
tension: bezier tension (-1.0 to 1.0)
Inputs: track_index (required), time (required), value (required), envelope_index, +3 more. Returns: object
insert_envelope_point_at_beatA
Insert an automation envelope point aligned to the project beat grid. Identify the envelope by name (e.g. 'Volume', 'Pan') or by 0-based envelope_index.
bar: 1-based measure number (bar 1 = project start)
beat: 1-based beat within the bar, may be fractional (e.g. 2.5 = beat 2 and a half). Beat units follow the time-signature denominator (e.g. quarter notes in 4/4, eighth notes in 6/8).
value: linear amplitude (Volume: 0.0=silence, 1.0=0 dB, 2.0=+6 dB max)
shape: 0=linear, 1=square, 2=slow start/end, 3=fast start, 4=fast end, 5=bezier Returns the resolved time in seconds alongside bar/beat for verification.
Inputs: track_index (required), bar (required), beat (required), value (required), +4 more. Returns: object
insert_midi_eventA
Insert a MIDI CC, pitch-bend, or program-change event into a MIDI item.
event_type: 'cc' | 'pitch_bend' | 'program_change'
ppq: position in PPQ ticks
channel: 0-15
cc: provide cc_number (0-127) and value (0-127)
pitch_bend: provide bend (-8192 to 8191, 0 = center)
program_change: provide program (0-127)
Inputs: track_index (required), item_index (required), event_type (required), ppq (required), +5 more. Returns: object
list_available_fxA
List installed FX plugins (VST, VST3, CLAP, and JS/JSFX).
filter: optional case-insensitive substring to match against plugin name or type e.g. 'fabfilter', 'vst3', 'clap', 'rea', 'comp'
Returns a list of {name, type} objects and a total count. type values: 'VST' (VST2), 'VST3', 'CLAP', 'JS'
Inputs: filter. Returns: object
list_fxA
List all FX plugins on a track (name, fx_index, n_params, enabled). Use track_index=-1 for the master track.
Inputs: track_index (required). Returns: object
list_fx_presetsA
List available presets for an FX already on a track. Returns two lists:
factory_presets: presets exposed by the plugin itself (CLAP, VST3, VST2 banks). Each entry has {index, name, source='factory'}. These can be loaded by name with set_fx_preset().
file_presets: .ffp/.fxp files found on disk under standard vendor preset dirs. Each entry has {name, category, path, source='file'}. Load via the 'path' field.
Inputs: track_index (required), fx_index (required). Returns: object
list_markersA
List all markers and regions in the project.
Inputs: no named parameters. Returns: object
list_tracksA
List every track in the project with volume, pan, mute, solo, arm state.
Inputs: no named parameters. Returns: object
move_media_itemC
Move a media item to a new timeline position (seconds).
Inputs: track_index (required), item_index (required), position (required). Returns: object
new_projectA
Create a new blank REAPER project (equivalent to File > New Project).
Inputs: no named parameters. Returns: object
normalize_trackA
Normalize a track to a target integrated loudness by measuring its current LUFS via a non-destructive dry-run render, then adjusting the track fader.
target_lufs: desired integrated loudness in LUFS (default -14.0, streaming standard). Use -23.0 for EBU R128 broadcast, -16.0 for podcast. Returns measured_lufs_i, gain_applied_db, and old/new fader volumes. The change is registered in REAPER's undo history.
Inputs: track_index (required), start_time (required), end_time (required), target_lufs. Returns: object
nudge_midi_notesA
Humanize all MIDI notes in an item with random timing and/or velocity offsets.
timing_range_ppq: maximum ±PPQ timing shift per note (0 = no timing change). At 960 PPQ, 20 PPQ ≈ 1/48th note of swing.
velocity_range: maximum ±velocity shift per note (0 = no velocity change). Velocity is clamped to 1-127.
seed: optional integer for reproducible results (omit for random each call). Returns the per-note changes applied.
Inputs: track_index (required), item_index (required), timing_range_ppq, velocity_range, +1 more. Returns: object
open_projectB
Open a REAPER project file (.rpp) by its absolute path.
Inputs: file_path (required). Returns: object
pingA
Check that the bridge is reachable. Returns bridge_version and reaper_version.
Inputs: no named parameters. Returns: object
remove_fxC
Remove an FX plugin from a track's FX chain.
Inputs: track_index (required), fx_index (required). Returns: object
remove_track_sendB
Remove a send from a track by its 0-based send index.
Inputs: track_index (required), send_index (required). Returns: object
render_time_selectionA
Render a time range to an audio file using REAPER's render pipeline.
output_path: absolute path including extension (e.g. '/tmp/mix.wav'). REAPER uses the current render format; set a .wav extension for PCM output.
start_time / end_time: seconds
sample_rate: 0 = use project rate
channels: 1=mono, 2=stereo Returns output_path and file_size_bytes so you can verify the file was written. After rendering, attach the file to this conversation so the audio can be heard.
Inputs: output_path (required), start_time (required), end_time (required), sample_rate, +1 more. Returns: object
resize_media_itemC
Change the length of a media item (seconds).
Inputs: track_index (required), item_index (required), length (required). Returns: object
save_projectA
Save the current REAPER project to disk.
Inputs: no named parameters. Returns: object
set_fx_enabledB
Enable or bypass (disable) a specific FX plugin on a track.
Inputs: track_index (required), fx_index (required), enabled (required). Returns: object
set_fx_paramB
Set an FX parameter by normalized value (0.0–1.0).
Inputs: track_index (required), fx_index (required), param_index (required), normalized_value (required). Returns: object
set_fx_presetA
Load a named preset for an FX plugin on a track. preset_name can be:
A plain preset name or index-based name (for plugins with internal preset banks)
A full absolute file path to a .ffp/.fxp/.fxb file (FabFilter and others). Use the 'path' field from list_fx_presets() for file-based plugins. On failure, returns loaded=false with a failure_reason: 'preset_name_not_found' - name not in the plugin's preset list 'plugin_rejected_state' - plugin returned false despite the name existing 'plugin_has_no_presets' - plugin exposes no preset bank at all 'file_unreadable' - path given but file could not be opened
Inputs: track_index (required), fx_index (required), preset_name (required). Returns: object
set_input_monitoringB
Set input monitoring mode for a track.
mode: 0 = off, 1 = on, 2 = not when playing
Inputs: track_index (required), mode (required). Returns: object
set_midi_noteA
Modify an existing MIDI note. Only the supplied fields are changed.
pitch: MIDI note number (0-127)
velocity: 0-127
channel: 0-15
start_ppq / end_ppq: positions in PPQ ticks
Inputs: track_index (required), item_index (required), note_index (required), start_ppq, +6 more. Returns: object
set_midi_notesA
Batch-edit multiple MIDI notes in one call. More efficient than calling set_midi_note() repeatedly. Each entry in 'notes' must have 'note_index' and any subset of: pitch, velocity, start_ppq, end_ppq, channel, selected, muted. Omitted fields keep their current values.
Inputs: track_index (required), item_index (required), notes (required). Returns: object
set_project_parameterB
Set a named project parameter. Supported parameters: loop_start, loop_end, loop_enabled, cursor_position, playrate
Inputs: parameter (required), value (required). Returns: object
set_tempoA
Set the project tempo (and optionally time signature).
bpm: beats per minute
time_sig_num / time_sig_denom: e.g. 3, 4 for 3/4 time
Inputs: bpm (required), time_sig_num, time_sig_denom. Returns: object
set_track_inputB
Set the recording input for a track.
For audio: 0-based audio input channel index.
For MIDI: use REAPER's I_RECINPUT encoding (e.g. 4096 + channel*32 + device).
Inputs: track_index (required), input_index (required). Returns: object
set_track_propertiesC
Modify one or more properties of a track.
volume: linear amplitude (1.0 = 0 dB)
pan: -1.0 (full left) to 1.0 (full right)
Inputs: track_index (required), name, volume, pan, +3 more. Returns: object
set_track_sendB
Set the volume and/or pan of a track send.
volume: linear amplitude (1.0 = 0 dB)
pan: -1.0 (full left) to 1.0 (full right)
Inputs: track_index (required), send_index (required), volume, pan. Returns: object
transportA
Control REAPER's transport. action: play | stop | pause | record | goto_start | goto_position position: required when action == goto_position (seconds)
Inputs: action (required), position. Returns: object
undoA
Trigger REAPER's undo. Returns the name of the action that was undone.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 57 tools
Most tools have distinct purposes, but there is some overlap in MIDI and envelope editing tools that could cause confusion. For example, 'set_midi_note' and 'set_midi_notes' are very similar, and 'insert_envelope_point' vs 'insert_envelope_point_at_beat' differ only in timing units. Descriptions help clarify, but an agent might misselect between closely related tools.
Tool names follow a consistent snake_case verb_noun pattern throughout, such as 'add_fx', 'create_track', 'get_project_info'. There are no deviations in naming conventions, making the set predictable and easy to parse for an agent.
With 57 tools, the count is excessive for a single server, even for a comprehensive DAW interface like REAPER. This many tools can overwhelm an agent and increase complexity, making it harder to navigate and select the right tool efficiently. A more focused subset would be more appropriate.
The tool set provides complete coverage for REAPER project management, including track, item, FX, MIDI, envelope, and transport operations. It supports full CRUD/lifecycle actions (e.g., create, get, update, delete) across all major domains, with no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for Producer/Riffusion AI music generation
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that exposes REAPER digital audio workstation functionality through a clean API interface, enabling programmatic control of 169+ REAPER operations across track management, MIDI editing, effects, automation and more.91MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables remote control and automation of FL Studio via the flapi Python client. It provides tools for managing transport, mixer tracks, pattern sequencing, and plugin parameters, allowing users to execute Python code directly within the FL Studio environment.2-
- AlicenseCqualityAmaintenanceA comprehensive MCP server that enables AI assistants to control REAPER DAW for mixing, mastering, MIDI composition, and full music production workflows with 130 tools.1871,166 PyPI114MIT
- AlicenseBqualityDmaintenanceThis MCP server enables AI assistants to control a live REAPER DAW instance, including transport, tracks, FX, MIDI, media, markers, rendering, and project state, with an escape hatch for arbitrary ReaScript commands.40MIT