reaper-mcp
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., "@reaper-mcp add a mastering chain to the master track"
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.
TwelveTake REAPER MCP
A TwelveTake Studios project.
Setup guide, examples and FAQ -> twelvetake.com/tools/reaper-mcp
Listed in the MCP Registry as mcp-name: com.twelvetake/reaper-mcp.
TwelveTake REAPER MCP is a Model Context Protocol server that enables AI assistants to control REAPER for mixing, mastering, MIDI composition and music production.
Version: 1.11.0
Why This Server
Workflow tools
In addition to direct control of REAPER, the server includes workflow tools that complete multi-step production tasks in a single call:
Tool | What it does for you |
| Creates send, routes to channels 3-4, configures ReaComp's detector input — complete sidechain setup in one call |
| Adds ReaEQ → ReaComp → ReaEQ → ReaLimit to master track with proper signal flow |
| Creates a bus track, sets up the send, adds compressor — NY-style compression ready to blend |
| Creates a submix track and routes your specified tracks to it |
| Returns track count, all track names/volumes/pans/FX, markers, regions, tempo, time signature — everything your AI needs in one call |
Zero Configuration
File-based communication works immediately — no network setup, no ports to configure
Stock REAPER only: the bridge is a plain Lua script and the analyzer is a JSFX plugin, so you don't install anything else in REAPER
Copy the script, run it, connect your AI assistant
188 Tools Covering Real Production Needs
Full FX control — add/remove plugins, get/set any parameter by index, manage presets, bypass
FX parameter automation — automate any plugin knob (flanger depth, filter cutoff, etc.)
Complete routing — sends, receives, sidechain routing to specific channel pairs
Automation — create envelopes, add/edit points, set automation modes
MIDI — create items, add notes individually or in batches, edit velocities
MIDI editing — transpose, quantize with swing, humanize, snap to a scale, stretch, legato, strum, velocity ramps — each targetable by pitch range, beat window, or channel
Audio items — import, split, duplicate, fade, position, mute
Markers & regions: create, rename, delete and jump to them
Session organizing: move tracks and folders, hide tracks from the arrange view or mixer, set track heights, rename takes and set the project playback rate
Measurement: loudness, loudness range, true peak, the octave-band spectrum and stereo correlation for the master, a track or an item. It passes the EBU's synthetic compliance signals for loudness, true peak and loudness range.
Undoable edits: every change the AI makes is one named step in REAPER's undo history ("MCP: delete track"), so Ctrl+Z in REAPER reverses one tool call at a time
Related MCP server: reaper-mcp
Requirements
REAPER (any recent version; full live suite green through REAPER 7.79)
Python 3.10+ (for the MCP server)
An MCP-compatible AI assistant
Installation
1. Install the Bridge Script in REAPER
The bridge is a Lua script that runs inside REAPER. The MCP server works on your project through it. Install it one of three ways.
Option A: one command, then run it once in REAPER
uvx twelvetake-reaper-mcp --install-bridgeThat copies reaper_mcp_bridge.lua into REAPER's Scripts folder for your platform, and the
TwelveTake MCP Analyzer, a JSFX plugin that the measurement tools use, into Effects/TwelveTake.
If a different copy of the bridge is already there, it backs that copy up first. It writes nothing
else, and the server never touches your REAPER installation on its own. Pass a path if REAPER is portable or installed
somewhere unusual: --install-bridge "/path/to/REAPER/Scripts".
Then load it in REAPER. Open Actions → Show action list:

Click New action → Load ReaScript:

Select reaper_mcp_bridge.lua in the Scripts folder and click Open:

The script is now in the action list. Select it and click Run:

The bridge runs in the background, without opening a window, until you close REAPER. Step 3 checks that it is working.
Next time, find it by typing mcp bridge in the action list's filter box, or have REAPER
start it for you (below).
Option B: ReaPack
If you use ReaPack, open Extensions → ReaPack → Import repositories:

and paste this address:
https://github.com/TwelveTake-Studios/reaper-mcp/raw/main/index.xml
Then open Extensions → ReaPack → Browse packages, find TwelveTake REAPER MCP bridge, right-click it, choose Install, and click OK:

ReaPack adds the script to the action list and installs the analyzer. Run the script from there as in option A.
Option C: by hand
Copy
reaper_mcp_bridge.luato your REAPER Scripts folder:Windows:
%APPDATA%\REAPER\Scripts\macOS:
~/Library/Application Support/REAPER/Scripts/Linux:
~/.config/REAPER/Scripts/
Copy
twelvetake_mcp_analyzer.jsfxtoEffects/TwelveTake/, next to that Scripts folder. The measurement tools need it; nothing else does.Load and run the script as in option A.
Start the bridge with REAPER
A script stops when REAPER closes. To have REAPER start the bridge every time it launches:
uvx twelvetake-reaper-mcp --install-bridge --autostartThat adds a marked block to __startup.lua in REAPER's Scripts folder, backing the file up
first, and leaves anything else in it alone. --remove-autostart takes the block out again.
If you installed with ReaPack, run uvx twelvetake-reaper-mcp --autostart instead; it points
REAPER at the ReaPack copy.
Updating
From 1.7.8 on, an update needs no step inside REAPER:
uvx twelvetake-reaper-mcp@latest --install-bridgeThe running bridge loads the new script by itself, and the command tells you so, for example:
The running bridge reloaded itself: 1.7.8 -> 1.7.9.With ReaPack, Extensions → ReaPack → Synchronize packages fetches the new script. It runs
the next time the bridge starts, or right away with uvx twelvetake-reaper-mcp --reload-bridge. The server also asks a running bridge to reload
when the bridge is too old for it.
Updating from 1.7.7 or older needs one last manual step: run the script in REAPER again after installing it.
2. Install and Configure the MCP Server
The server is published on PyPI as twelvetake-reaper-mcp. The simplest path is to let your
MCP client launch it with uvx (or pipx) — nothing to install by hand.
Add it to your MCP client's configuration (e.g. .mcp.json, or your client's MCP settings):
{
"mcpServers": {
"reaper": {
"command": "uvx",
"args": ["twelvetake-reaper-mcp"]
}
}
}VS Code uses a top-level
serverskey with"type": "stdio"instead ofmcpServers.
To confirm the server starts on its own:
uvx twelvetake-reaper-mcp
# or: pipx run twelvetake-reaper-mcpIt waits quietly for a client to connect — press Ctrl+C to stop.
3. Verify
With REAPER open and the bridge running, ask your assistant "how many tracks are in my project?" — a number back means the server, bridge, and REAPER are all talking.
Run from source (for development)
To work on the server itself, run it from a clone instead of from PyPI. Install the dependencies:
pip install -r requirements.txt # or: pip install "mcp>=1.2.0,<2.0"Point your MCP client at the local script:
{
"mcpServers": {
"reaper": {
"command": "python",
"args": ["path/to/reaper_mcp_server.py"]
}
}
}Then check the connection with:
python test_connection.pyNix flake (optional)
If you use Nix, the repo ships a flake-based dev shell that provides Python 3.12 and creates/activates a virtualenv for you:
# Enter the dev shell manually
nix develop
# Or, with direnv, auto-activate on cd:
direnv allowThen install the dependencies as usual:
pip install -r requirements.txtThis pins the Python version and keeps dependencies isolated from your system.
Note: the
x86_64-linuxdev shell is tested and working. The macOS (Darwin) shells are provided but have not been tested — confirmation from a macOS user is welcome.
How It Communicates
The server and the bridge exchange JSON files in a mailbox directory that the bridge script polls from inside REAPER. There is no network configuration and no port to open.
MCP Server REAPER Bridge
│ │
├── writes request_N.json ────►│
│ ├── processes request
│◄── reads response_N.json ────┤Bridge directory: REAPER's own Scripts/mcp_bridge_data, resolved per platform:
Platform | Path |
Windows |
|
macOS |
|
Linux |
|
Override with REAPER_BRIDGE_DIR for portable installs. The server prints the directory it
resolved to stderr on startup, and includes it in any timeout error.
The HTTP transport that shipped alongside this was removed in v1.7.2. It had been deprecated
since v1.2.1, and its request parser could never read a POST body, so no call it was handed
ever reached REAPER. REAPER_COMM_MODE no longer does anything.
Quick Start Examples
Basic Track Operations
"How many tracks are in my project?"
"Create a new track called 'Vocals'"
"Set track 0 volume to -6dB"
"Mute track 2"
"Solo the drums track"Mixing
"Add ReaComp to the bass track"
"Set up sidechain compression from the kick to the bass"
"Create a drum bus and route tracks 0-3 to it"
"Add a mastering chain to the master track"FX and Parameters
"What plugins are on track 0?"
"Get the parameters for the compressor on track 1"
"Set the threshold to -20dB"
"Bypass the EQ on the vocal track"MIDI Composition
"Create a 4-bar MIDI item on track 0"
"Add a C major chord at the start"
"Get all the notes in the MIDI item"
"Set the velocity of note 0 to 100"Transport and Navigation
"Play the project"
"Stop playback"
"Set the cursor to 30 seconds"
"Add a marker called 'Chorus' at the current position"Project Management
"What's the project tempo?"
"Set the tempo to 120 BPM"
"Save the project"
"Render to D:/Output/mix.wav"Tool Reference
Track Operations (26 tools)
Tool | Description |
| Get total number of tracks (excluding master) |
| Get track info (name, volume, pan, mute, solo, where it is hidden) |
| Get info for all tracks |
| Get master track info |
| Create a new track |
| Add a click track that follows the tempo map |
| Delete a track |
| Rename a track |
| Set volume in dB |
| Set pan (-1 to 1) |
| Mute/unmute track |
| Solo/unsolo track |
| Invert phase |
| Set stereo width (0-2) |
| Set track color |
| Get current peak level (dB) |
| Get held peak since last reset (dB) |
| Reset peak hold on all tracks |
| Get master/parent send state |
| Enable/disable master send |
| Set as folder parent/child |
| Move tracks above another track or to the end (a folder takes its children); |
| Show or hide tracks in the arrange view and mixer; set track height |
| Arm for recording |
| Set record input |
| Set monitor mode |
FX Operations (16 tools)
Tool | Description |
| Count FX on track |
| List all FX with details |
| Add FX plugin (optionally at position) |
| Reorder FX in the chain |
| Remove FX |
| Get FX name |
| Check if enabled |
| Enable/bypass FX |
| Count parameters |
| Get parameter name |
| Get parameter value |
| Set parameter value |
| List available presets |
| Get current preset |
| Load preset |
| Not supported: always returns an error, because REAPER's API cannot save a named FX preset |
ReaEQ Operations (5 tools)
Dedicated ReaEQ band control using REAPER's EQ-specific API, which handles ReaEQ's non-linear parameter curves (dB gain, log frequency, log Q) correctly.
Tool | Description |
| Find ReaEQ on a track (optionally add it) |
| Read all ReaEQ bands with human-readable values |
| Set a band parameter (Hz, dB, or Q) |
| Check whether a band is enabled |
| Enable/disable a band |
Take FX Operations (11 tools)
Per-take (per-item) FX, mirroring the track FX tools. Every take is addressed by
(track_index, item_index, take_index).
Tool | Description |
| Count FX on a take |
| List all take FX with details |
| Add FX plugin to a take |
| Remove FX from a take |
| Get take FX name |
| Check if enabled |
| Enable/bypass take FX |
| Count parameters |
| Get parameter name |
| Get parameter value |
| Set parameter value |
Take Management & Comping (8 tools)
Multi-take workflows: list/switch/delete takes, explode/crop, REAPER 7 fixed-lane comping.
Tool | Description |
| List all takes (name + active flag) |
| Get the active take index |
| Switch which take plays |
| Rename a take, the active one by default (an item shows its active take's name) |
| Explode takes to overlapping items (in place) |
| Keep only the active take |
| Delete a specific take |
| Play one fixed lane exclusively (lane comping) |
Routing (9 tools)
Tool | Description |
| Create send between tracks |
| Remove a send |
| Set send level |
| Count sends from track |
| Route to specific channels |
| Set source channels |
| Create sidechain send |
| Configure ReaComp sidechain |
| Complete sidechain setup |
Transport (12 tools)
Tool | Description |
| Start playback |
| Stop playback |
| Pause playback |
| Start recording |
| Get current state (playing/paused/recording) |
| Get edit cursor position (seconds) |
| Move edit cursor |
| Get playback position (seconds) |
| Toggle loop mode |
| Check if looping |
| Get the project playback rate |
| Set the project playback rate (0.25 to 4) |
Project (15 tools)
Tool | Description |
| Get comprehensive project state in one call |
| Save current project |
| Create new project (REAPER cannot name an unsaved project) |
| Open project file |
| Get project directory |
| Get project filename |
| Get project length (seconds) |
| Tempo at project start (BPM), plus every tempo marker |
| Set project tempo |
| Get time signature |
| Set time signature |
| Render to audio file; lists the project's normalization, fades and other processing, or skips them; waits for plugins to load first; reports the file's peak level, whether it is silent, and when its sound starts |
| Render the master mix over a region to an audio file, with |
| Zoom to time selection |
| Zoom to show entire project |
MIDI Operations (8 tools)
Tool | Description |
| Create empty MIDI item |
| Get MIDI item info |
| Add single note (beats) |
| Add multiple notes |
| Get all notes |
| Delete a note |
| Delete all notes |
| Change note velocity |
MIDI Utilities (14 tools)
Editing tools for notes that already exist. Every one takes the same optional filter — a pitch range, an onset window in beats from the item start, and a channel — so you can target a phrase without selecting anything by hand. Timing is in beats, pitch in semitones. Each is one undo step.
Tool | Description |
| Shift pitch; notes pushed outside 0-127 are left alone, never wrapped |
| Snap off-key notes onto a scale (named or a custom interval list) |
| Snap onsets to the project grid, with strength and swing |
| Shift notes in time; lengths preserved |
| Scale timing about a pivot (half-time / double-time) |
| Close the gaps in a line, or set every note to one length |
| Seeded, reproducible timing + velocity jitter |
| Roll a chord out into a strum |
| Linear velocity ramp across a phrase (crescendo) |
| Multiply / set / compress velocities |
| Edit one note's pitch, velocity, timing, channel |
| Read the notes selected in REAPER's editor |
| Select the notes matching a pitch/beat/channel filter |
| Trim or delete overlapping same-pitch notes |
remove_overlapping_midi_notes is the only one here that can remove notes; the rest only move
what is already there. It is flagged destructive so a client can prompt first.
Audio Items (17 tools)
Tool | Description |
| Import audio file |
| List all items on track |
| Get item details |
| Move item |
| Change item length |
| Delete item |
| Duplicate item |
| Split item at position |
| Mute/unmute item |
| Set item volume |
| Set fade-in |
| Set fade-out |
| Select all items |
| Deselect all items |
| Get selected items |
| Copy to clipboard |
| Paste from clipboard |
Markers & Regions (10 tools)
Tool | Description |
| Add marker |
| Add region |
| Get all markers |
| Get all regions |
| Delete marker |
| Delete region |
| Rename a marker, keeping its position and color |
| Rename a region, keeping its bounds and color |
| Jump to marker |
| Jump to region start |
Automation (8 tools)
Tool | Description |
| Get envelope by name |
| Count envelope points |
| Add automation point, creating the envelope if the track has none ( |
| Get all points |
| Delete point |
| Clear all points |
| Set automation mode |
| Arm envelope for recording |
FX Parameter Automation (5 tools)
Tool | Description |
| Get/create envelope for any FX parameter |
| Add automation point to FX parameter |
| Get all points from FX envelope |
| Delete point from FX envelope |
| Clear all points from FX envelope |
Selection & Editing (11 tools)
Tool | Description |
| Undo last action |
| Redo last undone action |
| Get undo/redo state |
| Select a track |
| Select all tracks |
| Deselect all tracks |
| Get selected track indices |
| Set time selection |
| Get time selection |
| Clear time selection |
| Delete selected items |
Measurement (3 tools)
Tool | Description |
| Integrated, short-term max and momentary max LUFS, loudness range, sample peak, true peak |
| Octave-band levels, spectral centroid, tilt, stereo correlation, side-to-mid, balance |
| Quiet stretches of an item, or of every audio item on a track, in project seconds with edges measured to the sample |
Both measure the master mix unless you give them a track or an item. The loudness figures come
from REAPER's own loudness measurement. True peak, the spectrum and the stereo figures come from the
TwelveTake MCP Analyzer, which --install-bridge installs and the ReaPack package includes.
Mixing Helpers (6 tools)
Tool | Description |
| Add EQ→Comp→EQ→Limiter to master |
| Set up NY compression |
| Create submix bus |
| Add ReaEQ |
| Add ReaComp |
| Add ReaLimit |
Advanced (4 tools)
Tool | Description |
| Run REAPER action by ID |
| Run action by name |
| Get raw FX state data |
| Cut items to clipboard |
Track Indexing
Regular tracks: 0-based index (first track = 0)
Master track: Use index
-1
"Set the master track volume to -3dB" → track_index = -1
"Mute track 1" → track_index = 1 (second track)Common Plugin Names
Use these names with track_fx_add_by_name():
Plugin | Name |
EQ |
|
Compressor |
|
Limiter |
|
Gate |
|
Delay |
|
Reverb |
|
Third-party plugins use their full name as shown in REAPER's FX browser.
Troubleshooting
"Cannot connect to REAPER"
Ensure REAPER is running
Ensure the bridge script is running: start it from the action list (type
mcp bridgein the filter box)Verify the bridge directory exists
"Track not found"
Track indices are 0-based
Use
-1for master trackCheck track count with
get_track_count()
Bridge script won't load
Deploy it with
twelvetake-reaper-mcp --install-bridge, then load and run it from REAPER's action list. REAPER runs the deployed copy, not the one in a clone.
Slow response
File-based mode has ~50ms latency per call
Batch operations when possible (e.g.,
add_midi_notes_batch)
Environment Variables
Variable | Default | Description |
| REAPER's | File bridge directory |
|
| Seconds to wait for the bridge to answer a call, except for the render and measurement tools below. The bridge answers only after the work finishes, so a slow operation such as freezing a track or opening a project can report a timeout while REAPER completes it normally. A higher value also delays the report when the bridge is not running. |
|
| Seconds to wait for |
| unset | Set to |
Contributing
See CONTRIBUTING.md. Read the first section before writing a patch: this repo is published from a private working repo through an explicit allowlist, so PRs are ported by hand rather than merged, and it is better to know that up front. A well-diagnosed issue is worth as much here as a patch and costs you far less.
Contributors
People outside the project whose work is in this software are listed in CONTRIBUTORS.md, including several whose diagnoses shipped before anyone here thought to look for them.
License
MIT License - see LICENSE
TwelveTake Studios LLC Website: twelvetake.com Contact: contact@twelvetake.com
Available Tools
187 toolsadd_compressorB
Add ReaComp to a track.
Returns: Object with fx_index.
Inputs: track_index (required).
add_envelope_pointA
Add a point to an envelope. A missing Volume, Pan, Width, Mute or Trim Volume envelope (or a Pre-FX one) is created first: REAPER starts it with a point at 0:00 holding the track's current value, and the response has envelope_created.
Args: envelope_name: Envelope name. time: Time position in seconds. value: Raw value. Pan -1..1 with +1 = LEFT (the reverse of set_track_pan); Width -1..1; Mute 0 = muted, 1 = unmuted. A raw volume value depends on the envelope's scaling, so use value_db there. shape: Point shape (0=linear, 1=square, 2=slow start/end, 3=fast start, 4=fast end, 5=bezier). value_db: Level in dB for Volume, Volume (Pre-FX) and Trim Volume; -150 is silence. Pass this or value.
Returns: point_index, value, and shown: the value as REAPER displays it ("-6.00dB", "50%L").
Inputs: time (required), track_index (required), envelope_name (required), shape, +2 more.
add_eqA
Add ReaEQ to a track.
Returns: Object with fx_index.
Inputs: track_index (required).
add_fx_envelope_pointB
Add an automation point to an FX parameter envelope.
Args: time: Time position in seconds. value: The parameter's own value, within the min..max track_fx_get_param reports (a JSFX dB slider takes dB). shape: Point shape (0=linear, 1=square, 2=slow start/end, 3=fast start, 4=fast end, 5=bezier).
Returns: point_index, value, and shown: the value as REAPER displays it.
Inputs: time (required), value (required), fx_index (required), param_index (required), +2 more.
add_limiterA
Add ReaLimit (brickwall limiter) to a track.
Returns: Object with fx_index.
Inputs: track_index (required).
add_markerA
Add a marker at a position.
Args: position: Position in seconds. name: Marker name. color: Marker color (0 = default).
Returns: Object with marker index.
Inputs: position (required), name, color.
add_mastering_chainA
Add a standard mastering chain to the master track.
Adds the following plugins in order:
ReaEQ (corrective EQ)
ReaComp (glue compression)
ReaEQ (tonal shaping)
ReaLimit (brickwall limiter)
Returns: Object with list of added FX indices.
Inputs: no named parameters.
add_midi_noteC
Add a MIDI note to an item using musical timing (beats).
Args: pitch: MIDI note number (0-127, 60 = middle C). velocity: Note velocity (1-127). start_beat: Start position in beats from the item start (0 = first beat). length_beats: Note length in beats (0.25 = sixteenth, 0.5 = eighth, 1.0 = quarter).
Example: Four-on-the-floor kick: add_midi_note(0, 0, 36, 110, start_beat=0, length_beats=0.25) then start_beat=1, 2, 3.
Inputs: pitch (required), velocity (required), item_index (required), start_beat (required), +3 more.
add_midi_notes_batchA
Add multiple MIDI notes to an item in one call, using musical timing (beats).
Args: notes: List of note dicts with keys: pitch, velocity, start_beat, length_beats, channel (optional).
Returns: Object with count of notes added.
Inputs: notes (required), item_index (required), track_index (required).
add_parallel_compressionA
Set up New York style parallel compression for a track.
Creates a new bus track with heavy compression, fed by a send from the source track.
Args: track_index: Source track index (0-based). blend_db: Send level in dB for the compressed signal (default -6dB).
Returns: Object with bus_track_index, send_index, and compressor_fx_index.
Inputs: track_index (required), blend_db.
add_regionA
Add a region.
Args: start: Start position in seconds. end: End position in seconds. name: Region name. color: Region color (0 = default).
Returns: Object with region index.
Inputs: end (required), start (required), name, color.
arm_trackB
Arm or disarm a track for recording.
Args: arm: True to arm, False to disarm.
Inputs: track_index (required), arm.
arm_track_envelopeC
Arm or disarm an envelope for recording.
Args: envelope_name: Envelope name. arm: True to arm, False to disarm.
Inputs: track_index (required), envelope_name (required), arm.
clear_all_peak_indicatorsAIdempotent
Clear the peak hold indicators on all tracks (including master).
Resets the held peak values that accumulate during playback. Use before a fresh playback pass when you want clean readings for gain staging.
Inputs: no named parameters.
clear_envelopeCDestructive
Delete all points from an envelope.
Args: envelope_name: Envelope name.
Inputs: track_index (required), envelope_name (required).
clear_fx_envelopeADestructive
Clear all automation points from an FX parameter envelope.
Returns: Object with deleted_count.
Inputs: fx_index (required), param_index (required), track_index (required).
clear_midi_itemBDestructive
Delete all MIDI notes from an item.
Returns: Object with count of notes deleted.
Inputs: item_index (required), track_index (required).
clear_time_selectionA
Clear the time selection.
Inputs: no named parameters.
configure_reacomp_sidechainA
Configure ReaComp to use sidechain input for detection.
Args: track_index: Track index (0-based) where ReaComp is located. fx_index: FX index (0-based) of ReaComp in the FX chain. use_sidechain: True to use auxiliary input (channels 3-4), False for main input.
Returns: Object with configuration status.
Inputs: fx_index (required), track_index (required), use_sidechain.
copy_selected_itemsC
Copy selected items to clipboard.
Inputs: no named parameters.
create_busA
Create a submix/stem bus and route specified tracks to it.
Args: name: Name for the bus track. source_track_indices: List of track indices to route to this bus.
Returns: Object with bus_track_index and routing info.
Inputs: name (required), source_track_indices (required).
create_click_trackA
Add a click track at the end of the track list. It holds REAPER's click source, which follows the tempo map and time signature changes and accents each downbeat.
Args: start: Start in seconds. end: End in seconds (default: the end of the project). name: Track name.
Returns: track_index, item_index, start, end.
Inputs: end, name, start.
create_midi_itemB
Create an empty MIDI item on a track.
Args: position: Start position in seconds. length: Length in seconds.
Returns: Object with item info including the new item_index.
Inputs: length (required), position (required), track_index (required).
create_projectADestructive
Create a new REAPER project.
Note: REAPER has no API to name a project that has never been saved, so this server
has no way to name one either. The removed name parameter never took effect.
Inputs: no named parameters.
create_sendA
Create a send from one track to another.
Args: src_track: Source track index (0-based). dest_track: Destination track index (0-based).
Returns: Object with send_index.
Inputs: src_track (required), dest_track (required).
crop_to_active_takeADestructive
Crop a media item to its active take, discarding all other takes.
Inputs: item_index (required), track_index (required).
cut_selected_itemsADestructive
Cut selected items to clipboard.
Inputs: no named parameters.
delete_envelope_pointCDestructive
Delete an envelope point.
Args: envelope_name: Envelope name.
Inputs: point_index (required), track_index (required), envelope_name (required).
delete_fx_envelope_pointCDestructive
Delete an automation point from an FX parameter envelope.
Args: point_index: Point index (0-based) to delete.
Inputs: fx_index (required), param_index (required), point_index (required), track_index (required).
delete_itemCDestructive
Delete a media item.
Inputs: item_index (required), track_index (required).
delete_markerADestructive
Delete a marker by index.
Inputs: marker_index (required).
delete_midi_noteCDestructive
Delete a MIDI note from an item.
Inputs: item_index (required), note_index (required), track_index (required).
delete_regionCDestructive
Delete a region by index.
Inputs: region_index (required).
delete_selected_itemsBDestructive
Delete all selected items.
Inputs: no named parameters.
delete_sendBDestructive
Delete a send from a track.
Args: track_index: Source track index (0-based). send_index: Send index (0-based) to delete.
Inputs: send_index (required), track_index (required).
delete_takeBDestructive
Delete a specific take from a media item.
Args: take_index: Take index to delete (0-based). The take is activated first, then removed.
Inputs: item_index (required), take_index (required), track_index (required).
delete_trackADestructive
Delete a track.
Args: track_index: Track index to delete (0-based). Cannot delete master track (-1).
Inputs: track_index (required).
duplicate_itemC
Duplicate a media item.
Returns: Object with new item info.
Inputs: item_index (required), track_index (required).
explode_takesADestructive
Explode all takes of a media item in place (each take becomes its own overlapping item).
Inputs: item_index (required), track_index (required).
find_eqA
Find ReaEQ on a track, optionally adding it if absent.
Args: instantiate: If True and ReaEQ is not present, add it.
Returns: Object with 'ret' = the FX index of ReaEQ, or -1 if not found.
Inputs: track_index (required), instantiate.
get_active_takeARead-only
Get the index of the active take of a media item.
Returns: Object with 'ret' = active take index (-1 if the item has no active take).
Inputs: item_index (required), track_index (required).
get_all_tracksARead-only
Get information about all tracks in the project, in get_track's shape plus index.
Inputs: no named parameters.
get_cursor_positionARead-only
Get the edit cursor position.
Returns: Object with cursor position in seconds.
Inputs: no named parameters.
get_envelope_point_countCRead-only
Get the number of points in an envelope.
Args: envelope_name: Envelope name.
Returns: Object with point count.
Inputs: track_index (required), envelope_name (required).
get_envelope_pointsCRead-only
Get all points from an envelope.
Args: envelope_name: Envelope name.
Returns: points (time, value, shape, shown). A volume envelope adds value_db to each point, and scaling.
Inputs: track_index (required), envelope_name (required).
get_eq_band_enabledARead-only
Check whether a ReaEQ band is enabled.
Args: fx_index: FX index (0-based) of ReaEQ. bandtype: Band type (0=hipass, 1=loshelf, 2=band, 3=notch, 4=hishelf, 5=lopass). bandidx: Band index within that type (0=first).
Returns: Object with 'ret' boolean (true=enabled).
Inputs: bandtype (required), fx_index (required), track_index (required), bandidx.
get_eq_bandsARead-only
Get all ReaEQ band settings in one structured call.
Args: fx_index: FX index (0-based) of ReaEQ in the FX chain.
Returns: Object with a 'bands' list. Each band has band_index, bandtype, bandtype_name, bandidx, paramtype, paramtype_name, normval, the REAPER-formatted value, and (for gain params) the computed gain_db.
Inputs: fx_index (required), track_index (required).
get_fx_envelopeA
Get or create an automation envelope for an FX parameter.
This enables automation of any FX parameter (e.g., a flanger knob in Guitar Rig). The envelope is created if it doesn't exist.
Args: param_index: Parameter index (0-based). Use track_fx_get_num_params() to find available parameters.
Returns: Object with envelope_name, param_name, point_count, and indices.
Inputs: fx_index (required), param_index (required), track_index (required).
get_fx_envelope_pointsBRead-only
Get all automation points from an FX parameter envelope.
Returns: Object with list of points (time, value, shown, shape, tension, selected).
Inputs: fx_index (required), param_index (required), track_index (required).
get_fx_presetCRead-only
Get the current preset name of an FX.
Returns: Object with current preset name.
Inputs: fx_index (required), track_index (required).
get_fx_presetsCRead-only
Get list of presets available for an FX.
Returns: Object with list of preset names.
Inputs: fx_index (required), track_index (required).
get_item_infoCRead-only
Get information about a media item.
Returns: Object with item properties (position, length, take info, etc.).
Inputs: item_index (required), track_index (required).
get_markersARead-only
Get all markers in the project.
Returns: Object with list of markers (position, name, index).
Inputs: no named parameters.
get_master_trackCRead-only
Get information about the master track.
Inputs: no named parameters.
get_midi_itemCRead-only
Get information about a MIDI item.
Returns: Object with item info including position, length, note count.
Inputs: item_index (required), track_index (required).
get_midi_notesCRead-only
Get all MIDI notes from an item.
Returns: Object with list of notes.
Inputs: item_index (required), track_index (required), fields.
get_play_positionARead-only
Get the current playback position.
Returns: Object with play position in seconds.
Inputs: no named parameters.
get_play_rateARead-only
Get the project playback rate as rate (1.0 is normal speed).
Inputs: no named parameters.
get_play_stateBRead-only
Get the current playback state.
Returns: Object with play state info.
Inputs: no named parameters.
get_project_lengthARead-only
Get the length of the project (end of last item).
Returns: Object with project length in seconds.
Inputs: no named parameters.
get_project_nameARead-only
Get the project name.
Inputs: no named parameters.
get_project_pathARead-only
Get the project path.
Inputs: no named parameters.
get_project_summaryARead-only
Get a comprehensive summary of the current REAPER project.
Returns everything needed to understand the project state and give useful mixing/production advice in a single call.
Returns: Object with: - project_name: Name of the project file - project_path: Full path to the project - tempo: Project tempo in BPM - time_signature: {numerator, denominator} - project_length: Length in seconds - track_count: Total number of tracks - tracks: List of track info objects, each containing: - index: Track index (0-based) - name: Track name - volume_db: Volume in decibels - pan: Pan position (-1 to 1) - mute: Boolean mute state - solo: Boolean solo state - fx_count: Number of FX plugins - fx_names: List of FX plugin names - hidden_in: only for a hidden track, as in get_track - master: Master track info {volume_db, fx_count, fx_names, hidden_in} - markers: List of {index, position, name} - regions: List of {index, start, end, name}
Inputs: no named parameters.
get_regionsBRead-only
Get all regions in the project.
Returns: Object with list of regions (start, end, name, index).
Inputs: no named parameters.
get_repeat_stateARead-only
Get the current repeat state.
Returns: Object with repeat state (true/false).
Inputs: no named parameters.
get_selected_itemsARead-only
Get all selected media items.
Returns: Object with list of selected items.
Inputs: no named parameters.
get_selected_midi_notesARead-only
Read the MIDI notes currently SELECTED in REAPER's editor for the active take.
The escape hatch for "operate on what I've selected": select notes by hand in REAPER, call this to see which they are, then translate that into an explicit value filter (pitch range / beat window / channel) for the transform tools. Read-only, no undo.
Returns:
{ok, notes:[...], ret} - the selected notes, same shape as get_midi_notes (each note
carries item-relative start_beat/end_beat). index is REAPER's absolute PPQ-sorted
note index, so a partial selection is non-contiguous. Empty selection -> notes:[].
Inputs: item_index (required), track_index (required), fields.
get_selected_tracksARead-only
Get indices of all selected tracks.
Returns: Object with list of selected track indices.
Inputs: no named parameters.
get_takesBRead-only
List all takes of a media item.
Returns: Object with 'takes' array (each entry: index, name, is_active) and 'ret' = take count.
Inputs: item_index (required), track_index (required).
get_tempoARead-only
Get the tempo at project start as ret, and every tempo marker as tempo_markers.
Inputs: no named parameters.
get_time_selectionARead-only
Get the current time selection.
Returns: Object with start and end times.
Inputs: no named parameters.
get_time_signatureARead-only
Get the project time signature.
Inputs: no named parameters.
get_trackBRead-only
Get information about a track.
Returns: Object with 'info': guid, name, volume, volume_db, pan, muted, soloed, has_midi, has_audio, fx_names, role, and hidden_in (["arrange"], ["mixer"] or both) only for a hidden track.
Inputs: track_index (required).
get_track_countARead-only
Get the total number of tracks in the current REAPER project (excluding master track).
Inputs: no named parameters.
get_track_envelopeBRead-only
Get a track envelope by name.
Args: envelope_name: Envelope name (e.g., "Volume", "Pan", "Mute").
Returns: Object with envelope info.
Inputs: track_index (required), envelope_name (required).
get_track_fx_chunkARead-only
Get the raw state chunk from an FX plugin (includes preset/state data).
Useful for reading VSTi state data like Toontrack EZkeys chord progressions. The chunk contains the full serialized state of the plugin.
Returns: Object with 'chunk' containing the FX state data string.
Inputs: fx_index (required), track_index (required).
get_track_itemsCRead-only
Get all media items on a track.
Returns: Object with list of items.
Inputs: track_index (required).
get_track_master_sendARead-only
Get the master/parent send state of a track.
Returns: Object with 'ret' field (1 = enabled, 0 = disabled).
Inputs: track_index (required).
get_track_num_sendsARead-only
Get the number of sends from a track.
Inputs: track_index (required).
get_track_peakBRead-only
Get the current peak level of a track.
Args: channel: Channel (0=left, 1=right).
Returns: Object with peak value in dB.
Inputs: track_index (required), channel.
get_track_peak_holdARead-only
Get the peak hold level of a track (highest peak since meters were last reset).
Returns the max peak from a previous playback without needing to be actively playing - play the project, stop, then call this for gain staging.
Args: channel: Channel (0=left, 1=right).
Returns: Object with peak hold value in dB.
Inputs: track_index (required), channel.
get_undo_stateARead-only
Get the current undo/redo state.
Returns: Object with undo and redo descriptions.
Inputs: no named parameters.
go_to_markerB
Move the edit cursor to a marker.
Inputs: marker_index (required).
go_to_regionB
Move the edit cursor to a region start.
Inputs: region_index (required).
humanize_midi_notesA
Humanize MIDI: nudge timing and velocity by small random amounts, reproducibly.
Each note gets its own timing and velocity offset drawn from a bell curve. Note lengths are preserved (start and end move together) and pitches are never touched. The randomness is seeded, so the same take with the same seed and settings gives identical results every time. Velocities are clamped to 1-127 and counted in clamped; notes pushed past the item end are kept and reported in out_of_bounds.
Unlike the other timing tools, a note pushed before the item start is placed at the item start and counted in out_of_bounds, not clamped; clamped here counts only the velocity clamp.
Args: timing: Timing spread in beats (standard deviation); 0.02 is a subtle human feel, 0.0 leaves timing alone. velocity: Velocity spread (standard deviation, in velocity units); 0.0 leaves velocity alone. seed: Any integer. The same seed, settings and take give the same result. max_sigma: Cap on how far one note may stray, in multiples of the spread.
Inputs: item_index (required), track_index (required), seed, fields, +9 more.
insert_audio_fileB
Insert an audio file onto a track.
Args: file_path: Full path to the audio file. position: Position in seconds.
Returns: Object with track_index, item_index of the created item, and position.
Inputs: position (required), file_path (required), track_index (required).
insert_trackA
Insert a new track at the specified index.
Args: index: Position to insert track (0-based). If not specified, adds at end. name: Optional name for the new track.
Returns: Info about the created track.
Inputs: name, index.
legato_midi_notesA
Close the gaps in a MIDI line (legato), or set every note to one length.
Only note ends move; starts are never touched. "connect" extends each note's end to the next onset and never shortens anything; a gap wider than max_gap_beats is left as a rest and counted in gaps_preserved, and the last note is left alone. "fixed" instead sets every targeted note's length to length_beats. Notes whose new end passes the item end are kept and reported in out_of_bounds.
Args: mode: "connect" (extend each end to the next onset) or "fixed" (set every length). voice: connect only. "chordal" extends to the next onset of any note, so a chord's notes move together; "per_pitch" extends to the next note of the SAME pitch and channel, keeping interleaved voices independent. max_gap_beats: connect only. Gaps wider than this are left as rests (>= 0). length_beats: fixed only. The length every targeted note is set to (> 0).
Returns: {ok, notes_changed, clamped, skipped, out_of_bounds, gaps_preserved, notes:[...]}.
Inputs: item_index (required), track_index (required), mode, voice, +9 more.
measure_loudnessARead-only
Measure loudness as REAPER's loudness window does: integrated LUFS, short-term and momentary max, loudness range, sample peak, plus true peak.
Target: the master (default), a track, or one item (its track's output over the item, other items muted). start_time/end_time limit it to a range. It runs a render dry run, so it writes no files, puts selections back and adds no undo step. Measuring the master marks the project as modified, even though nothing in it changes.
Returns: integrated_lufs, short_term_max_lufs, momentary_max_lufs, loudness_range_lu, sample_peak_dbfs, true_peak_dbtp, samples_over_0dbfs, duration; a note when a figure is approximate or unavailable.
Inputs: end_time, item_index, start_time, track_index.
measure_spectrumARead-only
Measure tonal balance and stereo image: octave-band levels (31.5 Hz to 16 kHz), spectral centroid, tilt in dB per octave, stereo correlation overall and below 150 Hz, side-to-mid level and left/right balance.
Same targets and range as measure_loudness. Levels are dBFS with a full-scale sine at 0, as in REAPER. Needs the TwelveTake MCP Analyzer, which --install-bridge installs.
Inputs: end_time, item_index, start_time, track_index.
move_tracksB
Move tracks, in their current order, to just above before_index. A folder moves with its children.
Args: before_index: Counted before the move; the track count moves them to the end. into_folder: Make them children of the track above the destination.
Returns: tracks: [{from, to}], each listed track's index before and after.
Inputs: before_index (required), track_indices (required), into_folder.
nudge_midi_notesA
Shift MIDI notes in time by a number of beats (+ = later, - = earlier).
Start and end move together, so note lengths are preserved. A note pushed before the
item start clamps to it and one pushed past the item end is left there; both count in
out_of_bounds, not clamped.
Args: amount_beats: Signed beat shift (0.25 = a 16th later, -1.0 = a beat earlier). 0 = no-op.
Inputs: item_index (required), track_index (required), amount_beats (required), fields, +6 more.
open_projectBDestructive
Open a REAPER project file.
Args: path: Full path to the .rpp file.
Inputs: path (required).
paste_itemsA
Paste items from clipboard at edit cursor.
Inputs: no named parameters.
pauseB
Pause playback in REAPER.
Inputs: no named parameters.
playA
Start playback in REAPER.
Inputs: no named parameters.
quantize_midi_notesA
Quantize MIDI note onsets onto the grid (tighten sloppy timing, add swing).
Onsets snap to the PROJECT bar/beat grid, not to an offset from the item's own start,
and note lengths are preserved: start and end move together. Notes that land past the
item end are kept, and one that would land before the item start is placed at it; both
are counted in out_of_bounds (clamped stays 0 here).
Args: grid: Grid spacing in beats: 0.25 = 1/16, 0.5 = 1/8, 1.0 = 1/4. Must be > 0. strength: 0.0-1.0. 1.0 snaps exactly onto the grid, 0.5 moves each note halfway there, 0.0 is a no-op. swing: 0.0-1.0. 0.0 = straight, 1.0 = full triplet feel (off-beats at 66.7%), scaling linearly between. Only the off-beat (odd) grid cells are delayed.
Inputs: item_index (required), track_index (required), grid, swing, +8 more.
ramp_midi_note_velocitiesA
Apply a linear velocity ramp (crescendo / decrescendo) across MIDI notes.
Velocities interpolate by onset: the earliest note in the filtered set gets start_velocity, the latest gets end_velocity, everything between is linear. Notes sharing an onset (a chord) get the same velocity. Results clamp to 1-127.
Args: start_velocity: Velocity at the earliest onset (1-127; out of range clamps, not an error). end_velocity: Velocity at the latest onset (1-127).
Inputs: item_index (required), track_index (required), end_velocity (required), start_velocity (required), +7 more.
recordA
Start recording in REAPER.
Inputs: no named parameters.
redoADestructive
Redo the last undone action in REAPER.
Returns: Object with redo description.
Inputs: no named parameters.
remove_overlapping_midi_notesADestructive
Clean up overlapping MIDI notes (same pitch stacked on itself).
Two notes conflict only if they share a pitch AND a channel AND overlap in time, so a chord is never a conflict and notes that merely touch are left alone. "trim" shortens the earlier note to stop where the next begins, losing nothing; "delete" drops one note of each overlapping pair, keeping the louder (ties go to the longer note).
Either mode can remove notes: notes stacked on the exact same onset collapse to the loudest, since there is nothing to trim between them, and a trim left shorter than min_length_beats is removed rather than left as a click.
Args: mode: "trim" (shorten the earlier note) or "delete" (drop the quieter note). min_length_beats: A trimmed note left shorter than this is removed instead. Default 1/128 of a beat; 0 disables it. pitch_low, pitch_high: Notes outside the filter are invisible: never touched, and never counted as an overlap partner.
Returns: {ok, mode, notes_changed, clamped, skipped, out_of_bounds, notes_removed, trimmed, deduped, deleted, notes:[...]} where notes_removed = deduped + deleted.
Inputs: item_index (required), track_index (required), mode, fields, +7 more.
rename_markerAIdempotent
Rename the marker get_markers numbers marker_index, keeping its position and color. An empty name clears it.
Inputs: name (required), marker_index (required).
rename_regionAIdempotent
Rename the region get_regions numbers region_index, keeping its bounds and color. An empty name clears it.
Inputs: name (required), region_index (required).
render_projectADestructive
Render the project's master mix to an audio file. Apart from the path, source and
range, the project's own render settings apply: its format (a .wav extension selects
WAV), and its normalization, limiter, fades, trim and pad, which the response lists in
processing (empty when none applies).
If the target file already exists, this returns an error unless overwrite=True (which deletes the existing file first), as REAPER's overwrite prompt would block.
A plugin still loading samples can render silence, or sound that starts later than the
music (sound_starts_s); delay_seconds waits before the render, like REAPER's "Delay
render start" but without its prompt.
Args: output_path: Full path for output file (extension determines format). start_time: Start time in seconds (None = project start). end_time: End time in seconds (None = project end). tail_seconds: Extra seconds to render at end for reverb tails. overwrite: True to replace an existing file at output_path. skip_postprocessing: True to render without the project's normalization, limiter, fades, trim and pad, for a file you will measure or compare. delay_seconds: Seconds to wait before rendering (None = the project's setting, 0 = no wait). sound_threshold_db: Level (dBFS) the file must exceed to count as sound.
Returns:
Object with render status, REAPER's computed output target(s), processing,
delay_seconds waited, the file's peak_dbfs, silent (no signal at all), and
sound_starts_s (seconds into the file, None if never); a note says what to try.
Inputs: output_path (required), end_time, overwrite, start_time, +4 more.
render_regionBDestructive
Render the master mix over the region get_regions numbers region_index, from its start to its end. render_project's other options and its response apply, plus region {index, name, start, end}.
Inputs: output_path (required), region_index (required), overwrite, tail_seconds, +3 more.
run_actionCDestructive
Run a REAPER action by command ID.
Args: action_id: REAPER action/command ID number.
Inputs: action_id (required).
run_action_by_nameADestructive
Run a REAPER action by its named command id.
Named commands (e.g. ReaScripts "_RS12345" or SWS "SWS...") are resolved to a numeric command id via NamedCommandLookup before firing. A purely numeric string (e.g. "40297") is treated as a built-in command id and run directly; prefer run_action(action_id) for built-ins.
Args: action_name: Named command id (e.g. "_RS12345") or a numeric command id string.
Returns: If the named command cannot be resolved, returns {"ok": False, "error": ...} without firing any action.
Inputs: action_name (required).
save_fx_presetADestructive
Not supported: REAPER's API cannot save a named FX preset, so this tool always returns an error. Use get_track_fx_chunk to capture the current FX state.
Inputs: fx_index (required), preset_name (required), track_index (required).
save_projectADestructive
Save the current REAPER project.
Inputs: no named parameters.
scale_midi_note_velocitiesA
Scale MIDI note velocities: multiply, set to a fixed value, or compress toward a pivot. Results clamp to 1-127.
Args:
mode: "multiply" (velocity * ratio), "set" (velocity becomes value), or "compress"
(pivot + (velocity - pivot) * ratio).
ratio: Multiply factor (>= 0, no upper cap), or compress amount (0.0-1.0, where 0
collapses every note onto the pivot and 1.0 changes nothing).
value: Target velocity for "set" mode (1-127).
pivot: What compress pulls toward (1-127), or -1 for the rounded mean of the matched
notes' velocities (reported as pivot_used).
Returns: {ok, notes_changed, clamped, skipped, out_of_bounds, pivot_used, notes:[...]}.
Inputs: item_index (required), track_index (required), mode, pivot, +9 more.
select_all_itemsA
Select all media items.
Inputs: no named parameters.
select_all_tracksB
Select all tracks.
Inputs: no named parameters.
select_comp_laneAIdempotent
Make a fixed lane play exclusively on a track (REAPER 7 lane-based comping).
The track must be in fixed-lane mode (right-click track -> Track lanes). Returns a clear error if it is not, or if the lane index is out of range.
Args: lane_index: Fixed lane index to play exclusively (0-based).
Inputs: lane_index (required), track_index (required).
select_midi_notesB
Select the MIDI notes matching the filter, as if clicked in REAPER's MIDI editor.
Args: selected: False deselects the matching notes instead; with no filter, clears the selection. exclusive: When selecting, deselect every note that does not match.
notes_changed counts notes whose selection flipped.
Inputs: item_index (required), track_index (required), fields, channel, +7 more.
select_trackC
Select a track.
Args: exclusive: If True, deselect other tracks first.
Inputs: track_index (required), exclusive.
set_active_takeCIdempotent
Set the active take of a media item (which take plays).
Args:
Inputs: item_index (required), take_index (required), track_index (required).
set_cursor_positionA
Set the edit cursor position.
Args: position: Position in seconds from project start.
Inputs: position (required).
set_eq_bandA
Set a ReaEQ band parameter.
Pass real values by default: frequency in Hz (paramtype 0), gain in dB (paramtype 1), or Q (paramtype 2). Gain is converted to ReaEQ's normalized curve internally; freq and Q are sent raw.
Args: fx_index: FX index (0-based) of ReaEQ. bandtype: -1=master gain, 0=hipass, 1=loshelf, 2=band, 3=notch, 4=hishelf, 5=lopass, 6=bandpass, 7=parallel bandpass. bandidx: Band index within that type (0=first). Ignored for master gain. paramtype: 0=frequency (Hz), 1=gain (dB), 2=Q. Ignored for master gain. value: The value, in real units unless is_normalized=True. is_normalized: If True, value is a raw 0-1 normalized value written directly.
Inputs: value (required), bandidx (required), bandtype (required), fx_index (required), +3 more.
set_eq_band_enabledB
Enable or disable a ReaEQ band.
Args: fx_index: FX index (0-based) of ReaEQ. bandtype: Band type (0=hipass, 1=loshelf, 2=band, 3=notch, 4=hishelf, 5=lopass). bandidx: Band index within that type (0=first). enabled: True to enable, False to disable.
Inputs: bandtype (required), fx_index (required), track_index (required), bandidx, +1 more.
set_fx_presetC
Set the preset of an FX.
Args: preset_name: Preset name.
Inputs: fx_index (required), preset_name (required), track_index (required).
set_item_fade_inC
Set the fade-in length of a media item.
Args: length: Fade-in length in seconds.
Inputs: length (required), item_index (required), track_index (required).
set_item_fade_outC
Set the fade-out length of a media item.
Args: length: Fade-out length in seconds.
Inputs: length (required), item_index (required), track_index (required).
set_item_lengthB
Set the length of a media item.
Args: length: New length in seconds.
Inputs: length (required), item_index (required), track_index (required).
set_item_muteC
Mute or unmute a media item.
Args: mute: True to mute, False to unmute.
Inputs: mute (required), item_index (required), track_index (required).
set_item_positionC
Set the position of a media item.
Args: position: New position in seconds.
Inputs: position (required), item_index (required), track_index (required).
set_item_volumeC
Set the volume of a media item.
Args: volume_db: Volume in dB.
Inputs: volume_db (required), item_index (required), track_index (required).
set_midi_noteA
Edit one existing MIDI note in place: pitch, start, length and/or channel. Only the fields you pass change, and at least one is required. (Velocity: set_midi_note_velocity.)
note_index is REAPER's PPQ-sorted index from get_midi_notes / get_selected_midi_notes and is unstable - re-read after the edit, since the returned list reflects the new order.
Args: pitch: New pitch (0-127). start_beat: New start in beats from item start; length is preserved. A start before the item start clamps there and is counted in out_of_bounds, not clamped. length_beats: New length in beats (> 0), resized from the current start. channel: New MIDI channel (0-15).
Returns: {ok, notes_changed, clamped, skipped, out_of_bounds, notes:[...]}, or {ok:false, error} for a bad index, an empty edit, or an out-of-range value (nothing is written).
Inputs: item_index (required), note_index (required), track_index (required), pitch, +5 more.
set_midi_note_velocityC
Set the velocity of a MIDI note.
Args: velocity: New velocity (1-127).
Inputs: velocity (required), item_index (required), note_index (required), track_index (required).
set_play_rateAIdempotent
Set the project playback rate, 0.25 to 4 (1.0 is normal speed).
Inputs: rate (required).
set_send_dest_channelsC
Set the destination channels for a send (used for sidechain routing).
Args: track_index: Source track index (0-based). dest_chan: Destination channel pair (0=1-2 main, 2=3-4 sidechain, 4=5-6, etc.). For sidechain compression, use 2 to route to channels 3-4.
Inputs: dest_chan (required), send_index (required), track_index (required).
set_send_source_channelsB
Set the source channels for a send.
Args: track_index: Source track index (0-based). src_chan: Source channel (-1=none, 0=stereo 1-2, 1024+n=mono from channel n).
Inputs: src_chan (required), send_index (required), track_index (required).
set_send_volumeB
Set the volume of a track send.
Args: track_index: Source track index (0-based). volume_db: Send volume in dB.
Inputs: volume_db (required), send_index (required), track_index (required).
set_take_nameAIdempotent
Rename a take, the active one when take_index is left out. An item shows its active take's name.
Returns: take_index, name.
Inputs: name (required), item_index (required), track_index (required), take_index.
set_tempoA
Set the project tempo.
Args: bpm: Tempo in beats per minute.
Inputs: bpm (required).
set_time_selectionA
Set the time selection.
Args: start: Start time in seconds. end: End time in seconds.
Inputs: end (required), start (required).
set_time_signatureB
Set the project time signature.
Args: numerator: Beats per measure (e.g., 4 for 4/4). denominator: Beat unit (e.g., 4 for quarter note).
Inputs: numerator (required), denominator (required).
set_track_as_folderA
Set a track as a folder parent or child.
Args: folder_depth: 0=normal, 1=folder parent, -1=end of folder.
Inputs: track_index (required), folder_depth (required).
set_track_automation_modeB
Set the automation mode for a track.
Args: mode: 0=trim/read, 1=read, 2=touch, 3=write, 4=latch.
Inputs: mode (required), track_index (required).
set_track_colorC
Set the color of a track.
Args: r: Red component (0-255). g: Green component (0-255). b: Blue component (0-255).
Inputs: b (required), g (required), r (required), track_index (required).
set_track_displayAIdempotent
Show or hide tracks in the arrange view and the mixer, and set track height. Settings left out stay as they are.
Args: height: Pixels; 0 returns to REAPER's default. REAPER draws no track below its minimum height.
Returns: tracks: [{index, hidden_in}], hidden_in only for a hidden track.
Inputs: track_indices (required), height, show_in_mixer, show_in_arrange.
set_track_inputB
Set the record input for a track.
Args: input_index: Input index (-1=no input, 0+=hardware inputs, 4096+=virtual MIDI).
Inputs: input_index (required), track_index (required).
set_track_master_sendAIdempotent
Enable or disable the master/parent send on a track.
When enabled, the track's audio routes to its parent folder track (or the master if it has no parent). Disable it when a track should only output through its sends (e.g., routed exclusively to a bus).
Args: enabled: True to enable, False to disable.
Inputs: enabled (required), track_index (required).
set_track_monitorB
Set the monitor mode for a track.
Args: monitor: 0=off, 1=normal, 2=not when playing.
Inputs: monitor (required), track_index (required).
set_track_muteC
Set the mute state of a track.
Args: mute: True to mute, False to unmute.
Inputs: mute (required), track_index (required).
set_track_nameB
Set the name of a track.
Args: name: New name for the track.
Inputs: name (required), track_index (required).
set_track_panB
Set the pan position of a track.
Args: pan: Pan position from -1.0 (full left) to 1.0 (full right). 0 = center.
Inputs: pan (required), track_index (required).
set_track_phaseB
Set the phase inversion of a track.
Args: invert: True to invert phase, False for normal.
Inputs: invert (required), track_index (required).
set_track_soloB
Set the solo state of a track.
Args: solo: True to solo, False to unsolo.
Inputs: solo (required), track_index (required).
set_track_volumeC
Set the volume of a track in decibels.
Args: volume_db: Volume in dB (0 = unity gain, -inf to +12 typical range).
Inputs: volume_db (required), track_index (required).
set_track_widthA
Set the stereo width of a track.
Args: width: Width value (0=mono, 1=stereo, 2=200% width).
Inputs: width (required), track_index (required).
setup_sidechain_compressionA
Complete sidechain compression setup: creates send and configures compressor.
This is the all-in-one function for setting up sidechain compression. It creates a send from the trigger track to the target track's sidechain input and configures ReaComp to listen to that sidechain.
Args: trigger_track: Track that triggers compression (e.g., kick drum = track 0). target_track: Track to be compressed (e.g., bass = track 1). compressor_fx_index: Index of ReaComp in target track's FX chain. send_volume_db: Sidechain send volume in dB (default 0dB).
Returns: Object with complete setup info.
Example: For kick-triggered bass compression where: - Drums are on track 0 - Bass is on track 1 with ReaComp at FX index 2 Call: setup_sidechain_compression(0, 1, 2)
Inputs: target_track (required), trigger_track (required), compressor_fx_index (required), send_volume_db.
setup_sidechain_sendA
Create a sidechain send from one track to another track's FX sidechain input.
This creates a send routed to channels 3-4 of the destination track, which is the standard sidechain input for compressors like ReaComp.
Args: src_track: Source/trigger track index (e.g., kick drum). dest_track: Destination track index (e.g., bass with compressor). volume_db: Send volume in dB (default 0dB = unity).
Returns: Object with send_index and routing info.
Inputs: src_track (required), dest_track (required), volume_db.
snap_midi_notes_to_scaleA
Snap off-key MIDI notes onto a scale (fix a wrong note, force a part into a key).
Notes already in the scale are left alone; each off-scale note moves to the nearest
in-scale pitch, and under nearest a tie resolves toward the middle of the selection.
A note with no in-scale pitch left inside 0-127 stays put and is counted in skipped.
Args: root: Root pitch class, 0-11 (0=C, 1=C#, 2=D ... 11=B). mode: Scale name: major, minor, harmonic_minor, melodic_minor, dorian, phrygian, lydian, mixolydian, locrian, major_pentatonic, minor_pentatonic, blues, whole_tone, chromatic (aliases: ionian, aeolian, natural_minor). Or a custom list of semitone intervals from the root, each 0-11 (e.g. [0,2,4,7,9]). direction: "nearest" (closest scale tone), "up" or "down" (that way only, skipping a note rather than falling back to the other direction).
Returns:
{ok, notes_changed, clamped, skipped, out_of_bounds, notes:[...]}; notes is the
post-transform list, with indices re-synced after the sort.
Inputs: root (required), item_index (required), track_index (required), mode, +8 more.
split_itemC
Split a media item at a position.
Args: position: Split position in seconds (absolute project time).
Returns: Object with info about both resulting items.
Inputs: position (required), item_index (required), track_index (required).
stopA
Stop playback in REAPER.
Inputs: no named parameters.
stretch_midi_notesA
Stretch or compress MIDI timing (half-time, double-time, or any ratio).
Each targeted note scales as a rigid unit about one fixed pivot: its distance from the
pivot and its own length both multiply by factor, so the rhythm is preserved and only
the speed changes. Notes that land past the item end are kept as-is; one pushed before
the item start begins at the item start but keeps its scaled end, so it comes out
shorter. Both are counted in out_of_bounds (clamped stays 0 here).
Args: factor: Time scale ratio, must be > 0. 2.0 = twice as long (half-time), 0.5 = half as long (double-time). pivot_beat: The fixed point, in beats from the item start; may be negative. None = the earliest targeted onset.
Inputs: factor (required), item_index (required), track_index (required), fields, +7 more.
strum_midi_notesA
Strum chords: stagger the onsets of simultaneous notes so each chord rolls out.
Only onsets move; note lengths are preserved.
Args: spread_beats: Total first-to-last onset span within each chord (>= 0; 0 = no-op). direction: "up" strikes the lowest note of a chord first, "down" the highest. chord_window_beats: Onset tolerance for grouping notes into one chord (0 = exact same onset).
Inputs: item_index (required), track_index (required), spread_beats (required), fields, +8 more.
take_fx_add_by_nameB
Add an FX plugin to a take by name.
Args: fx_name: Name of the FX plugin to add (e.g., "ReaEQ", "ReaComp"). Use the exact plugin name as it appears in REAPER's FX browser.
Returns: Object with 'ret' field containing the new FX index (or -1 if it could not be added).
Inputs: fx_name (required), item_index (required), take_index (required), track_index (required).
take_fx_deleteCDestructive
Remove an FX plugin from a take.
Args:
Inputs: fx_index (required), item_index (required), take_index (required), track_index (required).
take_fx_get_countBRead-only
Get the number of FX plugins on a take.
Returns: Object with 'ret' field containing the FX count.
Inputs: item_index (required), take_index (required), track_index (required).
take_fx_get_enabledBRead-only
Get the enabled (not bypassed) state of an FX plugin on a take.
Args:
Returns: Object with 'ret' field (boolean).
Inputs: fx_index (required), item_index (required), take_index (required), track_index (required).
take_fx_get_listBRead-only
Get a list of all FX plugins on a take.
Returns: Object with 'fx' array, each entry having index, name, and enabled state.
Inputs: item_index (required), take_index (required), track_index (required).
take_fx_get_nameCRead-only
Get the name of an FX plugin on a take.
Args:
Inputs: fx_index (required), item_index (required), take_index (required), track_index (required).
take_fx_get_num_paramsCRead-only
Get the number of parameters for an FX plugin on a take.
Args:
Inputs: fx_index (required), item_index (required), take_index (required), track_index (required).
take_fx_get_paramCRead-only
Get a parameter value on a take's FX plugin.
Args:
Returns: Object with 'value', 'min', and 'max' for the parameter.
Inputs: fx_index (required), item_index (required), take_index (required), param_index (required), +1 more.
take_fx_get_param_nameCRead-only
Get the name of a parameter on a take's FX plugin.
Args:
Inputs: fx_index (required), item_index (required), take_index (required), param_index (required), +1 more.
take_fx_set_enabledBIdempotent
Enable or bypass an FX plugin on a take.
Args: enabled: True to enable, False to bypass.
Inputs: enabled (required), fx_index (required), item_index (required), take_index (required), +1 more.
take_fx_set_paramAIdempotent
Set a parameter value on a take's FX plugin.
Args: value: New value (typically normalized 0-1; check min/max via take_fx_get_param).
Inputs: value (required), fx_index (required), item_index (required), take_index (required), +2 more.
toggle_repeatA
Toggle repeat/loop mode.
Returns: Object with new repeat state.
Inputs: no named parameters.
track_fx_add_by_nameA
Add an FX plugin to a track by name.
Args: fx_name: Name of the FX plugin to add (e.g., "ReaEQ", "ReaComp", "ReaLimit"). Use the exact plugin name as it appears in REAPER's FX browser. position: Optional insertion position (0-based) in the FX chain. Default -1 adds at the end; 0 inserts at the beginning.
Returns: Info about the added FX including its index.
Inputs: fx_name (required), track_index (required), position.
track_fx_deleteBDestructive
Remove an FX plugin from a track.
Inputs: fx_index (required), track_index (required).
track_fx_get_countBRead-only
Get the number of FX plugins on a track.
Returns: Object with 'ret' field containing count.
Inputs: track_index (required).
track_fx_get_enabledBRead-only
Get the enabled state of an FX plugin.
Returns: Object with 'ret' field (boolean).
Inputs: fx_index (required), track_index (required).
track_fx_get_listARead-only
Get list of all FX plugins on a track.
Returns: Object with 'fx' array, one entry per FX with index, name, enabled and offline, plus fx_count. 'enabled' is False when the FX is bypassed. Normal FX chain only, not input/record FX or master monitoring FX.
Inputs: track_index (required).
track_fx_get_nameCRead-only
Get the name of an FX plugin.
Inputs: fx_index (required), track_index (required).
track_fx_get_num_paramsBRead-only
Get the number of parameters for an FX plugin.
Inputs: fx_index (required), track_index (required).
track_fx_get_paramARead-only
Get a specific parameter value of an FX plugin.
Returns: Object with value, min, max for the parameter.
Inputs: fx_index (required), param_index (required), track_index (required).
track_fx_get_param_nameBRead-only
Get the name of an FX parameter.
Inputs: fx_index (required), param_index (required), track_index (required).
track_fx_moveBIdempotent
Move an FX plugin to a new position within the same track's FX chain.
Args: fx_index: Current FX index (0-based) in the FX chain. new_position: Target position (0-based). 0 = beginning of the chain.
Inputs: fx_index (required), track_index (required), new_position (required).
track_fx_set_enabledB
Enable or disable an FX plugin.
Args: enabled: True to enable, False to bypass.
Inputs: enabled (required), fx_index (required), track_index (required).
track_fx_set_paramC
Set a parameter value on an FX plugin.
Args: value: New value for the parameter (typically normalized 0-1, check min/max).
Inputs: value (required), fx_index (required), param_index (required), track_index (required).
transpose_midi_notesA
Transpose MIDI notes by a number of semitones (12 = an octave).
A note that would land outside pitch 0-127 keeps its original pitch and is counted in
skipped instead.
Args: semitones: Signed shift; positive is up, negative is down. 0 = no-op.
Returns:
{ok, notes_changed, clamped, skipped, out_of_bounds, notes:[...]}, where notes is
the full note list after the transform, re-indexed.
Inputs: semitones (required), item_index (required), track_index (required), fields, +6 more.
undoADestructive
Undo the last action in REAPER.
Returns: Object with undo description.
Inputs: no named parameters.
unselect_all_itemsA
Unselect all media items.
Inputs: no named parameters.
unselect_all_tracksA
Unselect all tracks.
Inputs: no named parameters.
zoom_to_projectA
Zoom the arrange view to show the entire project.
Inputs: no named parameters.
zoom_to_selectionB
Zoom the arrange view to the time selection.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 187 tools
The set is broadly organized by resource (tracks, items, MIDI notes, FX, envelopes, markers, rendering), but there is substantial overlap between generic primitives and convenience wrappers: add_eq/add_compressor/add_limiter versus track_fx_add_by_name, create_send versus setup_sidechain_send versus setup_sidechain_compression, and get_track versus get_all_tracks versus get_project_summary. The detailed descriptions help, but with 187 tools an agent can easily misselect between the mirrored track_fx_* and take_fx_* families or between the many specialized helpers.
Most tools use readable snake_case, but the convention is not fully consistent: many follow verb_resource (get_track, set_track_volume, add_marker), while others are resource-prefixed (track_fx_get_count, take_fx_set_param, track_fx_add_by_name) and a few are noun-first or irregular (find_eq, crop_to_active_take, save_fx_preset). The grouping helps, but the mixed ordering and family prefixes mean there is no single predictable pattern throughout.
187 tools is an extreme surface for an MCP server, far beyond the 3–15 range that keeps an agent's tool selection tractable. REAPER is a large DAW, but many tools are convenience wrappers around overlapping primitives, so the count is not earned by unique capability alone.
Coverage is very broad: project lifecycle, tracks, routing, FX, takes, MIDI editing, item editing, automation, markers/regions, rendering, metering, selection, undo, and transport are all present. Some gaps remain, such as broader tempo/time-signature map editing and FX preset saving (explicitly unsupported), but most DAW workflows have a tool path.
Maintenance
Related MCP Connectors
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for Producer/Riffusion AI music generation
MCP server for progressive tool usage at any scale (see https://klavis.ai)
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseBqualityBmaintenanceA Model Context Protocol server that enables AI agents to create fully mixed and mastered tracks in REAPER DAW, supporting project management, MIDI composition, audio recording, and mixing automation.61185MIT
- 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
- AlicenseAqualityBmaintenanceAn MCP server that enables AI assistants to control Ableton Live, providing 104 tools for music production including track, clip, device, and mixer control.1561,216 PyPI80MIT
- FlicenseAqualityDmaintenanceMCP server for controlling REAPER digital audio workstation from natural language. It enables AI agents to create tracks, import audio, adjust mix parameters, and manage sessions through typed operations and a REAPER bridge.22-