Skip to main content
Glama

TwelveTake REAPER MCP

A TwelveTake Studios project.

Tools Buy Me a Coffee Ko-fi

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

setup_sidechain_compression()

Creates send, routes to channels 3-4, configures ReaComp's detector input — complete sidechain setup in one call

add_mastering_chain()

Adds ReaEQ → ReaComp → ReaEQ → ReaLimit to master track with proper signal flow

add_parallel_compression()

Creates a bus track, sets up the send, adds compressor — NY-style compression ready to blend

create_bus()

Creates a submix track and routes your specified tracks to it

get_project_summary()

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-bridge

That 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:

REAPER's Actions menu with Show action list highlighted

Click New action → Load ReaScript:

The action list with the New action menu open and Load ReaScript highlighted

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

The Load Script dialog in REAPER's Scripts folder with reaper_mcp_bridge.lua selected

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

The action list filtered to the bridge script, ready to 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:

REAPER's Extensions menu with ReaPack's Import repositories highlighted

and paste this address:

https://github.com/TwelveTake-Studios/reaper-mcp/raw/main/index.xml

ReaPack's Import repositories dialog with the address pasted in

Then open Extensions → ReaPack → Browse packages, find TwelveTake REAPER MCP bridge, right-click it, choose Install, and click OK:

ReaPack's package browser with Install highlighted for the bridge

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

  1. Copy reaper_mcp_bridge.lua to your REAPER Scripts folder:

    • Windows: %APPDATA%\REAPER\Scripts\

    • macOS: ~/Library/Application Support/REAPER/Scripts/

    • Linux: ~/.config/REAPER/Scripts/

  2. Copy twelvetake_mcp_analyzer.jsfx to Effects/TwelveTake/, next to that Scripts folder. The measurement tools need it; nothing else does.

  3. 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 --autostart

That 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-bridge

The 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 servers key with "type": "stdio" instead of mcpServers.

To confirm the server starts on its own:

uvx twelvetake-reaper-mcp
# or: pipx run twelvetake-reaper-mcp

It 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.py

Nix 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 allow

Then install the dependencies as usual:

pip install -r requirements.txt

This pins the Python version and keeps dependencies isolated from your system.

Note: the x86_64-linux dev 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

%APPDATA%\REAPER\Scripts\mcp_bridge_data

macOS

~/Library/Application Support/REAPER/Scripts/mcp_bridge_data

Linux

~/.config/REAPER/Scripts/mcp_bridge_data (or ~/.reaper/... for older installs)

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_track_count()

Get total number of tracks (excluding master)

get_track(index)

Get track info (name, volume, pan, mute, solo, where it is hidden)

get_all_tracks()

Get info for all tracks

get_master_track()

Get master track info

insert_track(index, name)

Create a new track

create_click_track(start, end, name)

Add a click track that follows the tempo map

delete_track(index)

Delete a track

set_track_name(index, name)

Rename a track

set_track_volume(index, db)

Set volume in dB

set_track_pan(index, pan)

Set pan (-1 to 1)

set_track_mute(index, mute)

Mute/unmute track

set_track_solo(index, solo)

Solo/unsolo track

set_track_phase(index, invert)

Invert phase

set_track_width(index, width)

Set stereo width (0-2)

set_track_color(index, r, g, b)

Set track color

get_track_peak(index, channel)

Get current peak level (dB)

get_track_peak_hold(index, channel)

Get held peak since last reset (dB)

clear_all_peak_indicators()

Reset peak hold on all tracks

get_track_master_send(index)

Get master/parent send state

set_track_master_send(index, enabled)

Enable/disable master send

set_track_as_folder(index, depth)

Set as folder parent/child

move_tracks(indices, before_index, into_folder?)

Move tracks above another track or to the end (a folder takes its children); into_folder makes them children of the track above

set_track_display(indices, show_in_arrange?, show_in_mixer?, height?)

Show or hide tracks in the arrange view and mixer; set track height

arm_track(index, arm)

Arm for recording

set_track_input(index, input)

Set record input

set_track_monitor(index, mode)

Set monitor mode

FX Operations (16 tools)

Tool

Description

track_fx_get_count(index)

Count FX on track

track_fx_get_list(index)

List all FX with details

track_fx_add_by_name(index, name, position?)

Add FX plugin (optionally at position)

track_fx_move(index, fx_index, new_position)

Reorder FX in the chain

track_fx_delete(index, fx_index)

Remove FX

track_fx_get_name(index, fx_index)

Get FX name

track_fx_get_enabled(index, fx_index)

Check if enabled

track_fx_set_enabled(index, fx_index, enabled)

Enable/bypass FX

track_fx_get_num_params(index, fx_index)

Count parameters

track_fx_get_param_name(index, fx_index, param)

Get parameter name

track_fx_get_param(index, fx_index, param)

Get parameter value

track_fx_set_param(index, fx_index, param, value)

Set parameter value

get_fx_presets(index, fx_index)

List available presets

get_fx_preset(index, fx_index)

Get current preset

set_fx_preset(index, fx_index, name)

Load preset

save_fx_preset(index, fx_index, name)

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_eq(track, instantiate?)

Find ReaEQ on a track (optionally add it)

get_eq_bands(track, fx)

Read all ReaEQ bands with human-readable values

set_eq_band(track, fx, bandtype, bandidx, paramtype, value, is_normalized?)

Set a band parameter (Hz, dB, or Q)

get_eq_band_enabled(track, fx, bandtype, bandidx?)

Check whether a band is enabled

set_eq_band_enabled(track, fx, bandtype, bandidx?, 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

take_fx_get_count(track, item, take)

Count FX on a take

take_fx_get_list(track, item, take)

List all take FX with details

take_fx_add_by_name(track, item, take, name)

Add FX plugin to a take

take_fx_delete(track, item, take, fx)

Remove FX from a take

take_fx_get_name(track, item, take, fx)

Get take FX name

take_fx_get_enabled(track, item, take, fx)

Check if enabled

take_fx_set_enabled(track, item, take, fx, enabled)

Enable/bypass take FX

take_fx_get_num_params(track, item, take, fx)

Count parameters

take_fx_get_param_name(track, item, take, fx, param)

Get parameter name

take_fx_get_param(track, item, take, fx, param)

Get parameter value

take_fx_set_param(track, item, take, fx, param, 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

get_takes(track, item)

List all takes (name + active flag)

get_active_take(track, item)

Get the active take index

set_active_take(track, item, take)

Switch which take plays

set_take_name(track, item, name, take?)

Rename a take, the active one by default (an item shows its active take's name)

explode_takes(track, item)

Explode takes to overlapping items (in place)

crop_to_active_take(track, item)

Keep only the active take

delete_take(track, item, take)

Delete a specific take

select_comp_lane(track, lane)

Play one fixed lane exclusively (lane comping)

Routing (9 tools)

Tool

Description

create_send(src, dest)

Create send between tracks

delete_send(index, send_index)

Remove a send

set_send_volume(index, send_index, db)

Set send level

get_track_num_sends(index)

Count sends from track

set_send_dest_channels(index, send_index, chan)

Route to specific channels

set_send_source_channels(index, send_index, chan)

Set source channels

setup_sidechain_send(src, dest, db)

Create sidechain send

configure_reacomp_sidechain(index, fx_index, use)

Configure ReaComp sidechain

setup_sidechain_compression(trigger, target, fx, db)

Complete sidechain setup

Transport (12 tools)

Tool

Description

play()

Start playback

stop()

Stop playback

pause()

Pause playback

record()

Start recording

get_play_state()

Get current state (playing/paused/recording)

get_cursor_position()

Get edit cursor position (seconds)

set_cursor_position(seconds)

Move edit cursor

get_play_position()

Get playback position (seconds)

toggle_repeat()

Toggle loop mode

get_repeat_state()

Check if looping

get_play_rate()

Get the project playback rate

set_play_rate(rate)

Set the project playback rate (0.25 to 4)

Project (15 tools)

Tool

Description

get_project_summary()

Get comprehensive project state in one call

save_project()

Save current project

create_project()

Create new project (REAPER cannot name an unsaved project)

open_project(path)

Open project file

get_project_path()

Get project directory

get_project_name()

Get project filename

get_project_length()

Get project length (seconds)

get_tempo()

Tempo at project start (BPM), plus every tempo marker

set_tempo(bpm)

Set project tempo

get_time_signature()

Get time signature

set_time_signature(num, denom)

Set time signature

render_project(path, start, end, tail, skip_postprocessing, delay_seconds, sound_threshold_db)

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_region(index, path, ...)

Render the master mix over a region to an audio file, with render_project's other options

zoom_to_selection()

Zoom to time selection

zoom_to_project()

Zoom to show entire project

MIDI Operations (8 tools)

Tool

Description

create_midi_item(track, pos, length)

Create empty MIDI item

get_midi_item(track, item)

Get MIDI item info

add_midi_note(track, item, pitch, vel, start_beat, length_beats, chan)

Add single note (beats)

add_midi_notes_batch(track, item, notes)

Add multiple notes

get_midi_notes(track, item)

Get all notes

delete_midi_note(track, item, note)

Delete a note

clear_midi_item(track, item)

Delete all notes

set_midi_note_velocity(track, item, note, vel)

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

transpose_midi_notes(track, item, semitones, ...)

Shift pitch; notes pushed outside 0-127 are left alone, never wrapped

snap_midi_notes_to_scale(track, item, root, mode, ...)

Snap off-key notes onto a scale (named or a custom interval list)

quantize_midi_notes(track, item, grid, strength, swing, ...)

Snap onsets to the project grid, with strength and swing

nudge_midi_notes(track, item, amount_beats, ...)

Shift notes in time; lengths preserved

stretch_midi_notes(track, item, factor, pivot_beat, ...)

Scale timing about a pivot (half-time / double-time)

legato_midi_notes(track, item, mode, voice, ...)

Close the gaps in a line, or set every note to one length

humanize_midi_notes(track, item, timing, velocity, seed, ...)

Seeded, reproducible timing + velocity jitter

strum_midi_notes(track, item, spread_beats, direction, ...)

Roll a chord out into a strum

ramp_midi_note_velocities(track, item, start_vel, end_vel, ...)

Linear velocity ramp across a phrase (crescendo)

scale_midi_note_velocities(track, item, mode, ratio, ...)

Multiply / set / compress velocities

set_midi_note(track, item, note, ...)

Edit one note's pitch, velocity, timing, channel

get_selected_midi_notes(track, item)

Read the notes selected in REAPER's editor

select_midi_notes(track, item, ...)

Select the notes matching a pitch/beat/channel filter

remove_overlapping_midi_notes(track, item, mode, ...)

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

insert_audio_file(track, path, pos)

Import audio file

get_track_items(track)

List all items on track

get_item_info(track, item)

Get item details

set_item_position(track, item, pos)

Move item

set_item_length(track, item, length)

Change item length

delete_item(track, item)

Delete item

duplicate_item(track, item)

Duplicate item

split_item(track, item, pos)

Split item at position

set_item_mute(track, item, mute)

Mute/unmute item

set_item_volume(track, item, db)

Set item volume

set_item_fade_in(track, item, length)

Set fade-in

set_item_fade_out(track, item, length)

Set fade-out

select_all_items()

Select all items

unselect_all_items()

Deselect all items

get_selected_items()

Get selected items

copy_selected_items()

Copy to clipboard

paste_items()

Paste from clipboard

Markers & Regions (10 tools)

Tool

Description

add_marker(pos, name, color)

Add marker

add_region(start, end, name, color)

Add region

get_markers()

Get all markers

get_regions()

Get all regions

delete_marker(index)

Delete marker

delete_region(index)

Delete region

rename_marker(index, name)

Rename a marker, keeping its position and color

rename_region(index, name)

Rename a region, keeping its bounds and color

go_to_marker(index)

Jump to marker

go_to_region(index)

Jump to region start

Automation (8 tools)

Tool

Description

get_track_envelope(track, name)

Get envelope by name

get_envelope_point_count(track, name)

Count envelope points

add_envelope_point(track, name, time, value, shape, value_db)

Add automation point, creating the envelope if the track has none (value_db: a volume level in dB)

get_envelope_points(track, name)

Get all points

delete_envelope_point(track, name, index)

Delete point

clear_envelope(track, name)

Clear all points

set_track_automation_mode(track, mode)

Set automation mode

arm_track_envelope(track, name, arm)

Arm envelope for recording

FX Parameter Automation (5 tools)

Tool

Description

get_fx_envelope(track, fx, param)

Get/create envelope for any FX parameter

add_fx_envelope_point(track, fx, param, time, value, shape)

Add automation point to FX parameter

get_fx_envelope_points(track, fx, param)

Get all points from FX envelope

delete_fx_envelope_point(track, fx, param, point)

Delete point from FX envelope

clear_fx_envelope(track, fx, param)

Clear all points from FX envelope

Selection & Editing (11 tools)

Tool

Description

undo()

Undo last action

redo()

Redo last undone action

get_undo_state()

Get undo/redo state

select_track(index, exclusive)

Select a track

select_all_tracks()

Select all tracks

unselect_all_tracks()

Deselect all tracks

get_selected_tracks()

Get selected track indices

set_time_selection(start, end)

Set time selection

get_time_selection()

Get time selection

clear_time_selection()

Clear time selection

delete_selected_items()

Delete selected items

Measurement (3 tools)

Tool

Description

measure_loudness(track, item, start, end)

Integrated, short-term max and momentary max LUFS, loudness range, sample peak, true peak

measure_spectrum(track, item, start, end)

Octave-band levels, spectral centroid, tilt, stereo correlation, side-to-mid, balance

find_silence(track, item, threshold_db, min_length_s)

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_mastering_chain()

Add EQ→Comp→EQ→Limiter to master

add_parallel_compression(track, db)

Set up NY compression

create_bus(name, tracks)

Create submix bus

add_eq(track)

Add ReaEQ

add_compressor(track)

Add ReaComp

add_limiter(track)

Add ReaLimit

Advanced (4 tools)

Tool

Description

run_action(action_id)

Run REAPER action by ID

run_action_by_name(name)

Run action by name

get_track_fx_chunk(track, fx)

Get raw FX state data

cut_selected_items()

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

ReaEQ

Compressor

ReaComp

Limiter

ReaLimit

Gate

ReaGate

Delay

ReaDelay

Reverb

ReaVerbate or ReaVerb

Third-party plugins use their full name as shown in REAPER's FX browser.

Troubleshooting

"Cannot connect to REAPER"

  1. Ensure REAPER is running

  2. Ensure the bridge script is running: start it from the action list (type mcp bridge in the filter box)

  3. Verify the bridge directory exists

"Track not found"

  • Track indices are 0-based

  • Use -1 for master track

  • Check 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_BRIDGE_DIR

REAPER's Scripts/mcp_bridge_data, resolved per platform

File bridge directory

REAPER_FILE_TIMEOUT

5.0

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.

REAPER_RENDER_TIMEOUT

600

Seconds to wait for render_project, measure_loudness and measure_spectrum, which run at roughly realtime. Raise it for renders longer than ten minutes.

REAPER_MCP_DEBUG

unset

Set to 1 before launching REAPER to see the bridge's start message and a console line for every call

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 tools
add_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:

  1. ReaEQ (corrective EQ)

  2. ReaComp (glue compression)

  3. ReaEQ (tonal shaping)

  4. 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_indicatorsA
Idempotent

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_envelopeC
Destructive

Delete all points from an envelope.

Args: envelope_name: Envelope name.

Inputs: track_index (required), envelope_name (required).

clear_fx_envelopeA
Destructive

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_itemB
Destructive

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_projectA
Destructive

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_takeA
Destructive

Crop a media item to its active take, discarding all other takes.

Inputs: item_index (required), track_index (required).

cut_selected_itemsA
Destructive

Cut selected items to clipboard.

Inputs: no named parameters.

delete_envelope_pointC
Destructive

Delete an envelope point.

Args: envelope_name: Envelope name.

Inputs: point_index (required), track_index (required), envelope_name (required).

delete_fx_envelope_pointC
Destructive

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_itemC
Destructive

Delete a media item.

Inputs: item_index (required), track_index (required).

delete_markerA
Destructive

Delete a marker by index.

Inputs: marker_index (required).

delete_midi_noteC
Destructive

Delete a MIDI note from an item.

Inputs: item_index (required), note_index (required), track_index (required).

delete_regionC
Destructive

Delete a region by index.

Inputs: region_index (required).

delete_selected_itemsB
Destructive

Delete all selected items.

Inputs: no named parameters.

delete_sendB
Destructive

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_takeB
Destructive

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_trackA
Destructive

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_takesA
Destructive

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_takeA
Read-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_tracksA
Read-only

Get information about all tracks in the project, in get_track's shape plus index.

Inputs: no named parameters.

get_cursor_positionA
Read-only

Get the edit cursor position.

Returns: Object with cursor position in seconds.

Inputs: no named parameters.

get_envelope_point_countC
Read-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_pointsC
Read-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_enabledA
Read-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_bandsA
Read-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_pointsB
Read-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_presetC
Read-only

Get the current preset name of an FX.

Returns: Object with current preset name.

Inputs: fx_index (required), track_index (required).

get_fx_presetsC
Read-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_infoC
Read-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_markersA
Read-only

Get all markers in the project.

Returns: Object with list of markers (position, name, index).

Inputs: no named parameters.

get_master_trackC
Read-only

Get information about the master track.

Inputs: no named parameters.

get_midi_itemC
Read-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_notesC
Read-only

Get all MIDI notes from an item.

Returns: Object with list of notes.

Inputs: item_index (required), track_index (required), fields.

get_play_positionA
Read-only

Get the current playback position.

Returns: Object with play position in seconds.

Inputs: no named parameters.

get_play_rateA
Read-only

Get the project playback rate as rate (1.0 is normal speed).

Inputs: no named parameters.

get_play_stateB
Read-only

Get the current playback state.

Returns: Object with play state info.

Inputs: no named parameters.

get_project_lengthA
Read-only

Get the length of the project (end of last item).

Returns: Object with project length in seconds.

Inputs: no named parameters.

get_project_nameA
Read-only

Get the project name.

Inputs: no named parameters.

get_project_pathA
Read-only

Get the project path.

Inputs: no named parameters.

get_project_summaryA
Read-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_regionsB
Read-only

Get all regions in the project.

Returns: Object with list of regions (start, end, name, index).

Inputs: no named parameters.

get_repeat_stateA
Read-only

Get the current repeat state.

Returns: Object with repeat state (true/false).

Inputs: no named parameters.

get_selected_itemsA
Read-only

Get all selected media items.

Returns: Object with list of selected items.

Inputs: no named parameters.

get_selected_midi_notesA
Read-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_tracksA
Read-only

Get indices of all selected tracks.

Returns: Object with list of selected track indices.

Inputs: no named parameters.

get_takesB
Read-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_tempoA
Read-only

Get the tempo at project start as ret, and every tempo marker as tempo_markers.

Inputs: no named parameters.

get_time_selectionA
Read-only

Get the current time selection.

Returns: Object with start and end times.

Inputs: no named parameters.

get_time_signatureA
Read-only

Get the project time signature.

Inputs: no named parameters.

get_trackB
Read-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_countA
Read-only

Get the total number of tracks in the current REAPER project (excluding master track).

Inputs: no named parameters.

get_track_envelopeB
Read-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_chunkA
Read-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_itemsC
Read-only

Get all media items on a track.

Returns: Object with list of items.

Inputs: track_index (required).

get_track_master_sendA
Read-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_sendsA
Read-only

Get the number of sends from a track.

Inputs: track_index (required).

get_track_peakB
Read-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_holdA
Read-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_stateA
Read-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_loudnessA
Read-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_spectrumA
Read-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_projectB
Destructive

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.

redoA
Destructive

Redo the last undone action in REAPER.

Returns: Object with redo description.

Inputs: no named parameters.

remove_overlapping_midi_notesA
Destructive

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_markerA
Idempotent

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_regionA
Idempotent

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_projectA
Destructive

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_regionB
Destructive

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_actionC
Destructive

Run a REAPER action by command ID.

Args: action_id: REAPER action/command ID number.

Inputs: action_id (required).

run_action_by_nameA
Destructive

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_presetA
Destructive

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_projectA
Destructive

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_laneA
Idempotent

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_takeC
Idempotent

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_rateA
Idempotent

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_nameA
Idempotent

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_displayA
Idempotent

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_sendA
Idempotent

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_deleteC
Destructive

Remove an FX plugin from a take.

Args:

Inputs: fx_index (required), item_index (required), take_index (required), track_index (required).

take_fx_get_countB
Read-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_enabledB
Read-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_listB
Read-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_nameC
Read-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_paramsC
Read-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_paramC
Read-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_nameC
Read-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_enabledB
Idempotent

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_paramA
Idempotent

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_deleteB
Destructive

Remove an FX plugin from a track.

Inputs: fx_index (required), track_index (required).

track_fx_get_countB
Read-only

Get the number of FX plugins on a track.

Returns: Object with 'ret' field containing count.

Inputs: track_index (required).

track_fx_get_enabledB
Read-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_listA
Read-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_nameC
Read-only

Get the name of an FX plugin.

Inputs: fx_index (required), track_index (required).

track_fx_get_num_paramsB
Read-only

Get the number of parameters for an FX plugin.

Inputs: fx_index (required), track_index (required).

track_fx_get_paramA
Read-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_nameB
Read-only

Get the name of an FX parameter.

Inputs: fx_index (required), param_index (required), track_index (required).

track_fx_moveB
Idempotent

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.

undoA
Destructive

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

    C2.9/5.0

    Scored across 187 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      This 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.
      40
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that enables AI assistants to control Ableton Live, providing 104 tools for music production including track, clip, device, and mixer control.
      156
      1,216 PyPI
      80
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP 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
      -