Skip to main content
Glama
LiveSession MCP
by Uri-Rosen

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ABLETON_HOSTNoHost of the Remote Script. Default: localhost
ABLETON_PORTNoPort of the Remote Script. Default: 9877
LIVESESSION_TOOLSETSNoTool groups to expose (e.g. core,compose,mix,listen). Default: all
LIVESESSION_LISTEN_DIRNoWhere you export bounces for listening. Default: ~/Music/LiveSession/Listen
LIVESESSION_CATALOG_DIRNoPlug-in catalogue, snapshots, layouts directory. Default: app data folder

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

LiveSession MCP controls a running Ableton Live (11 or 12) through its Remote Script, and reads Live Sets on disk with Live closed.

Conventions

  • Indices are zero-based (tracks, clips/scenes, devices, returns). Time is in beats (quarter notes); a 4/4 bar is 4 beats. Session clips are addressed by (track_index, clip_index = scene row).

  • Start with get_session_snapshot (or get_session_info + get_track_tree) before editing.

  • Prefer semantic tools (add_effect, set_control, apply_chain_recipe, write_chords...) over raw parameters.

  • Group several edits with run_batch: one round trip, one undo step.

Safety

  • Tools marked destructive delete or overwrite material. Before a destructive step on a saved set, the server saves it first so Live keeps the previous version in the project's Backup folder.

  • undo reverts the last steps. Mix snapshots (save_mix_snapshot) capture faders, sends and device values.

What Live's API can't do, and what this server does instead

  • Export: prepare_export opens the Export dialog; listen_latest then analyses the bounce.

  • Save / freeze / bounce / group: run through Live's menu (save_live_set, freeze_track, group_tracks).

  • Third-party plug-in parameters: only those Live exposes (Configure); get_plugin_profile knows them all, and process_audio_with_plugins renders audio through any plug-in offline.

  • Arrangement automation envelopes and tempo automation are not reachable; use clip automation.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_session_infoB

Get detailed information about the current Ableton session

Parameters:

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_remote_script_infoA

Report Ableton Remote Script version and capabilities (handshake).

Use this to verify the Live-side bridge matches this MCP server package.

get_track_infoC

Get detailed information about a specific track in Ableton.

Parameters:

  • track_index: The index of the track to get information about

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_clip_notesA

Read all MIDI notes from a Session-view clip.

Returns pitch, start_time, duration, velocity, mute (and extended fields when available).

Parameters:

  • track_index: Track that owns the clip

  • clip_index: Session clip slot index

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_device_parametersB

Read all parameters for a device on a track (name, value, min, max).

Parameters:

  • track_index: Track that owns the device

  • device_index: Index into the track's device chain

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

set_device_parameterA

Set a device parameter to a specific value.

Use get_device_parameters first to discover parameter indices and ranges.

Parameters:

  • track_index: Track that owns the device

  • device_index: Index into the track's device chain

  • parameter_index: Index into device.parameters

  • value: New parameter value (Live parameter units)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_session_snapshotA

Capture a full project state snapshot for trajectory recording.

Includes session metadata, every track (mixer, devices, session clips, arrangement clips), optional MIDI notes, and optional device parameters. Used to version musical state S_t → S_{t+1}.

Parameters:

  • include_notes: Include MIDI note arrays in clips (default True)

  • include_params: Include device parameter values (default True)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

create_midi_trackB

Create a new MIDI track in the Ableton session.

Parameters:

  • index: The index to insert the track at (-1 = end of list)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

create_audio_trackA

Create a new audio track in the Ableton session.

Use this for recorded or imported audio (samples, stems, vocals). For MIDI instruments use create_midi_track instead.

Parameters:

  • index: The index to insert the track at (-1 = end of list)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

set_track_nameB

Set the name of a track.

Parameters:

  • track_index: The index of the track to rename

  • name: The new name for the track

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

create_clipB

Create a new MIDI clip in the specified track and clip slot.

Parameters:

  • track_index: The index of the track to create the clip in

  • clip_index: The index of the clip slot to create the clip in

  • length: The length of the clip in beats (default: 4.0)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

create_audio_clipA

Create a new audio clip in an audio track's clip slot by importing a file.

Requires Ableton Live 12.0.5 or newer — the underlying ClipSlot.create_audio_clip Live API was introduced in 12.0.5 and is not available in earlier 12.0.x releases.

Parameters:

  • track_index: The index of the audio track to create the clip in

  • clip_index: The index of the clip slot to create the clip in

  • path: Absolute path to a supported audio file (e.g. a .wav). The target track must be an audio track and the clip slot must be empty.

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

add_notes_to_clipB

Add MIDI notes to a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • notes: List of note dictionaries, each with pitch, start_time, duration, velocity, and mute

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

clear_notes_from_clipA

Remove all MIDI notes from a Session clip.

Writes are additive (add_notes_to_clip only appends), so to truly modify a clip you clear it first, then add the new notes. Use this with get_clip_notes and add_notes_to_clip for a real read -> modify -> write loop: read the notes, edit the list, clear_notes_from_clip, then add_notes_to_clip the edited notes.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

set_clip_nameA

Set the name of a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • name: The new name for the clip

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

set_arrangement_clip_nameA

Set the name of a clip placed in the Arrangement timeline.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip within track.arrangement_clips, in the same order returned by get_arrangement_clips (i.e. ordered by start_time)

  • name: The new name for the clip

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

set_tempoB

Set the tempo of the Ableton session.

Parameters:

  • tempo: The new tempo in BPM

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

load_instrument_or_effectB

Load an instrument or effect onto a track using its URI.

Parameters:

  • track_index: The index of the track to load the instrument on

  • uri: The URI of the instrument or effect to load (e.g., 'query:Synths#Instrument%20Rack:Bass:FileId_5116')

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

fire_clipC

Start playing a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

stop_clipC

Stop playing a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

delete_clipA

Delete the clip in the given clip slot, freeing it for reuse.

Use this before create_clip when you want to overwrite an existing clip (create_clip itself refuses to write into an occupied slot).

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot to clear

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

start_playbackB

Start playing the Ableton session.

Parameters:

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

stop_playbackB

Stop playing the Ableton session.

Parameters:

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_browser_treeA

Get a hierarchical tree of browser categories from Ableton.

Parameters:

  • category_type: Type of categories to get ('all', 'instruments', 'sounds', 'drums', 'audio_effects', 'midi_effects')

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_browser_items_at_pathB

Get browser items at a specific path in Ableton's browser.

Parameters:

  • path: Path in the format "category/folder/subfolder" where category is one of the available browser categories in Ableton

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

load_drum_kitA

Load a drum rack and then load a specific drum kit into it.

Parameters:

  • track_index: The index of the track to load on

  • rack_uri: The URI of the drum rack to load (e.g., 'Drums/Drum Rack')

  • kit_path: Path to the drum kit inside the browser (e.g., 'drums/acoustic/kit1')

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

switch_to_arrangement_viewB

Switch Ableton's main window to the Arrangement view.

Parameters:

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

set_arrangement_timeA

Move the arrangement playhead to a specific position.

Parameters:

  • time: Position in beats from the start of the arrangement (e.g. 8.0 = bar 3 in 4/4)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_arrangement_clipsA

List all clips placed in the Arrangement timeline for a track.

Returns each clip's name, start_time, end_time, length, and type.

Parameters:

  • track_index: The index of the track to inspect

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

duplicate_to_arrangementA

Copy a Session-view clip into the Arrangement timeline.

Uses Live's track.duplicate_clip_to_arrangement() API (Live 11 / 12). The clip is placed at destination_time beats from the start of the arrangement on the same track it lives in.

Typical workflow:

  1. create_clip / add_notes_to_clip to build a Session clip

  2. Call duplicate_to_arrangement once per bar/section you need

  3. Call switch_to_arrangement_view to confirm the result in Live

Parameters:

  • track_index: Index of the track that owns the Session clip

  • clip_index: Index of the clip slot in that track (Session view)

  • destination_time: Beat position in the arrangement to place the clip (e.g. 0.0 = start, 8.0 = bar 3 in 4/4)

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

create_locatorA

Create a named locator (cue point) in the Arrangement at a beat position.

If a locator already exists at that beat (within ~1e-3 tolerance) it is renamed instead of toggled off. Time is in beats from the start of the arrangement (e.g. 0.0 = start, 16.0 = bar 5 in 4/4).

Parameters:

  • name: The locator label (e.g. "Chorus", "Verse 1", "Drop")

  • time: Beat position where the locator should sit

  • user_prompt: The original user prompt that led to this tool call (for telemetry)

get_mixerB

Volume, pan, mute, solo, arm, sends, colour and device names for every track, return and master. Volume is Live's 0.0-1.0 fader value (0.85 = 0 dB); volume_display shows dB.

set_mixerA

Set any of a track's mixer controls in one call; omitted controls are left alone.

  • volume: 0.0-1.0 fader value (0.85 = 0 dB, 0.0 = -inf)

  • pan: -1.0 (left) to 1.0 (right)

  • sends: {"0": 0.5, "1": 0.2} keyed by return index, 0.0-1.0

  • track_type: "track" (default), "return" or "master" (track_index is ignored for master)

delete_trackB

Delete a track or return track. Undo with undo() if it was a mistake.

duplicate_trackB

Duplicate a track with its clips and devices; the copy lands right after it.

set_track_colorB

Set a track's colour by Live palette index (0-69).

delete_deviceB

Remove a device or plug-in from a track, by index or (fuzzy) name.

set_device_onC

Turn a device on or off (bypass), by index or (fuzzy) name.

move_deviceB

Reorder a device in its chain, or move it to another track (target_track_index).

undoA

Undo the last N actions in Live (same as Ctrl+Z).

redoA

Redo N undone actions in Live (same as Ctrl+Y).

list_pluginsA

List installed VST3/AU plug-ins Live can load, with vendor folder. Filter with query (name or vendor).

load_pluginA

Load a plug-in onto a track by (fuzzy) name, e.g. "Pro-Q 4", "valhalla vintage", "Keyscape". Effects append to the end of the chain; instruments replace the track's instrument. track_type: "track" (default), "return" or "master" (track_index is ignored for master)

list_racksB

List device/rack presets (.adg/.adv) saved in the User Library — e.g. your vocal-chain templates.

load_rackC

Load a saved rack/preset from the User Library onto a track by (fuzzy) name.

get_device_paramsB

Read a device's or plug-in's parameters with readable values (e.g. "300 Hz", "-3.0 dB"). query filters by parameter name. For plug-ins exposing only 'Device On', the result carries a hint: use Configure in Live (or plugin_window tools + computer use) to expose more controls.

set_device_paramA

Set one parameter on a device or plug-in, found by (fuzzy) name or index.

Give exactly one of:

  • value: raw value within the parameter's min..max (see get_device_params)

  • normalized: 0.0-1.0 across the parameter's range

  • option: a named choice for switch/menu parameters (e.g. "Low Cut") Returns the before/after values including the readable display string.

get_plugin_presetsB

List the presets/programs a plug-in exposes to Live, and which one is selected.

set_plugin_presetC

Switch a plug-in to one of its exposed presets, by (fuzzy) name or index.

select_deviceB

Select a device and show Live's device view, so its Configure button and plug-in window toggle are on screen for computer use.

create_sceneB

Create a scene (row in Session view) at index (-1 = end), optionally named.

delete_sceneC

Delete a scene row.

fire_sceneC

Launch every clip in a scene row.

set_scene_nameC

Rename a scene (e.g. "Verse", "Chorus").

set_clip_loopC

Set a Session clip's loop region in beats and/or turn looping on/off.

quantize_clipC

Quantize a clip. grid: 1/4, 1/8, 1/8t, 1/8+t, 1/16, 1/16t, 1/16+t, 1/32. amount 0.0-1.0.

transpose_clipB

Transpose a clip: MIDI notes are moved; audio clips get their pitch shifted.

set_clip_colorC

Set a clip's colour by Live palette index (0-69).

set_clip_automationC

Draw automation inside a Session clip as steps.

  • parameter: with device_index omitted, a mixer control: "volume", "pan" or "send 0"; otherwise a parameter name/index on that device

  • points: [{"time": beats, "value": raw value}, ...]; each value holds until the next point Example — fade the volume up over 4 bars: points=[{"time":0,"value":0.4},{"time":8,"value":0.6},{"time":16,"value":0.85}]

clear_clip_automationB

Clear one parameter's automation from a clip, or all of it when parameter is omitted.

set_transportC

Arrangement record, Session record, overdub, metronome, loop region (beats) and time signature. Arm the tracks first with set_mixer(arm=True).

get_routingC

A track's audio/MIDI input and output routing, with every available option.

set_routingC

Set routing by (fuzzy) display name, e.g. input_type="Ext. In", input_channel="1".

list_live_windowsA

List open Ableton Live windows (main window and every floating plug-in window) with their screen position and size — use these coordinates to aim computer-use clicks.

focus_live_windowA

Bring an Ableton window (main or plug-in, matched by part of its title) to the front.

screenshot_live_windowA

Screenshot one Ableton window — e.g. a plug-in like "Pro-Q 4" — cropped to just that window. Bring it to the front first (focus_live_window) if something covers it. Image pixel (px, py) maps to screen (x + pxscale, y + pyscale) using the returned x, y, scale.

get_metersA

Live peak levels (0.0-1.0, 1.0 = 0 dBFS) of every track, return and the master, read right now. Call while playback runs to spot clipping or quiet tracks without exporting.

get_song_scaleA

The song's key and scale as set in Live 12 (root note, scale name, intervals).

set_song_scaleA

Set the song key, e.g. root="A", scale_name="Minor"; scale_mode=True highlights it in MIDI clips.

create_return_trackB

Add a return track (for shared reverb/delay); returns its return index for set_mixer sends.

create_arrangement_clipA

Create an empty MIDI clip directly in the Arrangement at beat start. Fill it with write_chords/write_melody(arrangement=True, clip_index=).

delete_arrangement_clipB

Delete an Arrangement clip (index as listed by get_arrangement_clips).

set_audio_clipB

Audio clip settings: gain (0-1), warping, warp_mode (beats, tones, texture, re-pitch, complex, complex pro — use complex pro for vocals/full mixes), pitch in semitones/cents, name.

search_browserA

Search Live's whole browser: instruments, audio_effects, midi_effects, sounds, drums, samples, plugins, user_library, packs. Load a result with load_browser_uri.

load_browser_uriB

Load any browser item (preset, sample, device, kit) by URI onto a track, return or the master.

set_sidechainB

Route a track (by name, e.g. "Drums") into a Compressor's sidechain input and switch S/C On. Live's API routes sidechains only into Compressor (not Glue Compressor, Gate or Auto Filter).

scan_plugin_catalogA

Profile installed VST3 plug-ins outside Live: every parameter (not just what Live exposes), presets, and a role (eq, compressor, reverb, piano...). Resumes where it stopped; call again while 'remaining' > 0; retry_failed re-tries plug-ins that failed before (e.g. after activating them). Modified binaries (broken signature, R2R imports) are listed as excluded, never loaded.

find_pluginsB

Catalogued plug-ins filtered by role (eq, compressor, limiter, deesser, gate, multiband, reverb, delay, saturation, modulation, mastering, pitch, piano, strings, drums, bass, synth) or name/vendor.

get_plugin_profileB

Full catalogue profile of one plug-in: all parameters with ranges and options, presets, roles, and its semantic map (mix/threshold/decay... -> real parameter names).

add_effectA

Add an effect or instrument by role — "reverb", "eq", "compressor", "deesser", "delay", "saturation", "limiter", "glue", "plate", "hall", "piano", "strings", "bass", "drums"... — using the best installed plug-in and falling back to Live's own device. prefer forces a specific one.

set_controlB

Set a musical control on ANY device without knowing its parameter names: control is one of mix, threshold, ratio, attack, release, output, input, decay, predelay, size, feedback, delay_time, cutoff, resonance, high_cut, low_cut, width, ceiling, gain, frequency. device is the device's name on the track. If the plug-in hasn't exposed it to Live, the reply names the exact plug-in parameter and the expose step.

build_chainC

Build an effect chain by purpose from whatever is installed: vocal, piano, strings, cello, bass, drums, bus, master.

create_song_templateB

Build a Nir Canaan-style singer-songwriter session: Piano, Cello, Strings, Bass, Drums, Lead and Backing Vocal tracks with instruments and chains, plus Vocal Plate / Hall / Delay returns and sensible sends. Uses the best installed plug-ins for each role.

write_chordsB

Write a chord progression by symbol into a Session clip (created if empty), with smooth voice leading.

  • chords: ["Am7", "Fmaj7", "C/E", "G7sus4"] — also add9, m7b5, dim7, 6/9, 9, 11, 13...

  • style: close, open, spread (two-hand piano), drop2, shell, power

  • pattern: block, half, arp_up, arp_down, arp_updown, broken, pulse8

  • center: MIDI note the voicing sits around (60 = middle C)

write_progressionC

Write a progression in roman numerals in any key, e.g. key="A", scale="minor", numerals=["i", "VI", "III", "VII"] or key="C", numerals=["I", "vi7", "IV", "V7", "bVII"].

write_melodyB

Write a melody from scale degrees (1 = root, 8 = octave up, 0 = rest) and durations in beats. Scales: major, minor, harmonic minor, melodic minor, dorian, phrygian, lydian, mixolydian, locrian, major/minor pentatonic, blues, phrygian dominant.

humanize_clipB

Loosen an existing MIDI clip: small random timing (beats) and velocity changes.

chord_infoB

Spell chords without writing them: notes of each voicing, e.g. to check a progression.

save_mix_snapshotA

Save every track's mixer state and exposed device parameter values under a name (A/B compare).

list_mix_snapshotsB

List saved mix snapshots.

restore_mix_snapshotB

Bring the mixer (and device parameters) back to a saved snapshot. Tracks are matched by index and name.

expose_plugin_paramsA

Prepare exposing a plug-in's controls to Live (needed when get_device_params shows only 'Device On'). Selects the device, finds its window, lists the exact parameter names to touch (from the catalogue) and any saved GUI layout, and returns the computer-use steps.

save_plugin_layoutA

Remember where controls sit in a plug-in's window, as fractions of the window (0-1): {"Mix": {"x": 0.07, "y": 0.38}, "Decay": {"x": 0.21, "y": 0.42}}. Reused on any later session.

get_plugin_layoutC

A remembered plug-in GUI layout (control positions as window fractions), if one was saved.

process_audio_with_pluginsA

Render an audio file through catalogued plug-ins outside Live, to audition settings before committing. chain: [{"plugin": "ValhallaVintageVerb", "params": {"Mix": 25, "Decay": 2.5}}, ...] Values are in the units the plug-in displays (25 = 25 %, 2.5 = 2.5 s, 300 = 300 Hz) or option names; see get_plugin_profile for each parameter's range and units. Then analyse the result with listen_file (optionally against the original).

prepare_exportB

Set the loop/export range and open Live's Export Audio/Video dialog (Live's API has no export call), then return the steps to render into the listen folder for listen_latest / match_reference.

write_basslineA

Write a bass part that follows the chords (slash basses respected) into a Session clip. style: whole, root_fifth, pop8, ballad (root + passing note), walking, octaves, arp. low/high: MIDI range (28 = E1, the lowest bass string).

generate_melodyB

Generate a singable melody over a progression: chord tones on strong beats, mostly steps, a phrase shape and breaths. contour: arch, rise, fall, wave, question_answer. density 0..1 (0.3 ballad, 0.7 busy). Change seed for another idea; same seed = same melody.

write_drum_patternB

Write a drum pattern for a Drum Rack (GM layout: kick 36, rim 37, snare 38, hat 42, crash 49). style: ballad, pop, halftime, six_eight, brush_rim, four_floor, fill. notes remaps pads, e.g. {"crash": 48} — get_drum_pads shows what each pad holds.

swing_clipA

Swing a Session MIDI clip: delay off-beat 8ths (or 16ths) by amount (0..1 of the grid; 0.33 ≈ triplet feel). For Live's own grooves use set_clip_groove.

build_song_structureA

Lay a song out in the Arrangement from Session scenes, with a named locator per section. sections: [{"name": "Intro", "scene": 0}, {"name": "Verse 1", "scene": 1}, {"name": "Chorus", "scene": 2, "bars": 8}, ...] — each section copies every clip in that scene row to the timeline (repeated to fill "bars" if given, else the longest clip in the row). Tracks without a clip in the row stay silent.

get_locatorsA

All Arrangement locators (name, beat) and the song length.

set_locatorB

Create or rename a locator at a beat (reliable: waits for Live's playhead to move first).

delete_locatorC

Delete the locator at a beat.

duplicate_clip_loopC

Double a clip's loop with its notes (Live's 'Duplicate Loop').

crop_clipC

Crop a clip to its loop/start-end region.

duplicate_clip_regionB

Copy a time range of a MIDI clip's notes to another beat inside the same clip.

get_track_treeB

Every track with its group membership, fold and freeze state.

set_track_foldB

Fold or unfold a group track.

press_live_shortcutA

Bring Live to the front and press keys there, e.g. "tab" (switch view), "ctrl+shift+r" (export), "shift+tab". Live ignores some synthetic Ctrl shortcuts (Ctrl+S, Ctrl+G): use run_live_menu for those.

run_live_menuA

Run any command from Live's menu bar by its label — "Save Live Set", "Freeze Tracks", "Flatten", "Bounce Tracks in Place", "Consolidate", "Group Tracks", "Ungroup Tracks", "Duplicate", "Insert Audio Track"... track_index selects that track first. No keyboard focus needed. Commands that act on a selection use what is selected in Live; check the result afterwards.

save_live_setA

Save the current Live Set (File > Save Live Set). A never-saved set opens Live's Save dialog for a name.

group_tracksA

Group a contiguous range of tracks into a Group Track and optionally name it. One track is grouped straight away. For a range, Live needs the track names selected by mouse (its API selects only one track): click the first track's name and shift-click the last, then call this. Anything other than exactly those tracks getting grouped is undone.

freeze_trackA

Freeze a track (Edit > Freeze Tracks) and wait until Live finishes rendering it; flatten=True instead prints it to audio for good (Edit > Bounce Tracks in Place: the track becomes an audio track and its devices are removed — undo restores them). Frees CPU from heavy plug-ins.

get_drum_padsC

The pads of the track's Drum Rack (also inside an Instrument Rack): note, name, devices.

load_drum_padB

Load a sample or instrument from the browser onto one Drum Rack pad (36 = C1 = first pad). query searches samples/drums/sounds/packs (e.g. "brush snare"); uri loads an exact search_browser hit.

load_sampleA

Put a sample into Simpler. query/uri: from Live's browser onto the track (an empty MIDI track gets a new Simpler). path: a .wav/.aif on disk replaces the sample in the track's existing Simpler.

set_simplerC

Simpler playback: mode classic / one-shot / slicing; slice_by transient, beat, region, manual; sensitivity 0..1 for transient slicing; warp the sample on/off.

insert_deviceA

Insert one of Live's own devices by name ("EQ Eight", "Compressor", "Utility"...) at a chain position (-1 = end) — faster than a browser search.

get_warp_markersB

Warp markers of an audio clip (beat_time in the song, sample_time in seconds in the file).

add_warp_markerB

Add a warp marker at beat_time (pinning the audio at sample_time seconds, or where it currently plays).

move_warp_markerB

Move the warp marker at beat_time by distance beats (stretches the audio around it).

remove_warp_markerC

Remove the warp marker at beat_time.

get_groovesB

Grooves in the Groove Pool and the song's global groove amount.

set_clip_grooveA

Apply a Groove Pool groove to a clip by name; amount = global groove amount (0-1.3, 0 = no effect). Live's API can't detach a groove again (pick None in the clip's Groove box in Live), so prefer swing_clip for a reversible swing. Load grooves into the pool by double-clicking them in Live's Grooves browser.

get_take_lanesC

A track's take lanes (comping) and the clips on each.

create_take_laneB

Add a take lane to a track (for comping several takes).

import_audio_to_arrangementA

Place an audio file on an audio track's Arrangement timeline at a beat (e.g. a vocal take or a reference).

match_referenceA

Compare a bounce with a reference song (level-matched tonal balance, loudness, width) and turn the differences into EQ moves. apply=True puts an EQ Eight named "Ref Match" on the master (or track_type/track_index) with those moves — strength 0..1 of the difference, capped at max_db.

gain_stageA

Play the song and watch every track's peak meter for a few seconds, then set faders so each track peaks around target_peak_db (default -6 dBFS) — a clean starting balance before mixing. Tracks that stay silent are left alone. apply=False only reports.

learn_plugin_profileA

Record the parameters a loaded plug-in exposes in Live into the catalogue. This is the fallback profile for plug-ins the offline scanner can't load (Keyscape, Pianoteq, LABS, Serum 2, MODO BASS...) and it refreshes what Live exposes for any plug-in after Configure. Then get_plugin_profile, set_control and add_effect can use it.

apply_chain_recipeC

Build a ready-dialled chain from Live's own devices (works on any machine, every parameter set): vocal_pop (EQ Eight HPF + presence, Compressor 3:1, de-ess, Glue), piano_ballad (gentle HPF, warm low-mid dip, light compression), strings_pad (HPF, air, wide), cello_solo, bass_warm, drums_soft, master_soft (gentle glue, EQ tilt, limiter at -1 dB).

inspect_live_apiA

Read-only look at Live's Python API: list the attributes (and simple values) of the object at a dotted path such as 'song', 'song.tracks[0].mixer_device' or 'app.browser'. contains filters names. Use it to check whether Live exposes something before writing a new command.

listen_latestA

Analyse the newest audio file in the listen folder (where bounces are exported): loudness, true peak, tonal balance, stereo, key and likely problems, plus a picture (spectrogram, spectrum, loudness over time). Use after the user (or prepare_export) bounced something from Live.

listen_fileA

Analyse a specific WAV/AIFF/FLAC file, optionally against a reference track (a commercial song in the same style): loudness and tonal-balance differences, level-matched.

list_exportsB

Audio files in the listen folder, newest first.

run_batchA

Run several tools in one call as ONE undo step in Live (one Ctrl+Z reverts them all). steps: [{"tool": "create_midi_track", "args": {"index": -1}}, {"tool": "set_track_name", "args": {"track_index": 3, "name": "Pad"}}, ...]. Results come back in order; with stop_on_error the batch stops at the first failure (earlier steps stay applied — call undo once to revert the batch). Desktop, export and analysis tools can't be batched.

session_diffA

See what changed in the open set. mark=True records the current state (do it before an edit); mark=False compares now with the last mark: tracks added/removed/reordered, devices, clips, faders, mute/solo, groups, returns, locators, tempo.

song_starterA

Start a song in a genre in one step: the session template (instruments, chains, returns) plus a first scene with chords, bass, drums and a melody that fit together. Genres: ballad, pop, mizrahi_pop, singer_songwriter, cinematic, house, six_eight. key/tempo override the genre's; change seed for another idea. build_template=False writes the parts into the existing Piano/Bass/Drums tracks instead.

write_euclideanB

Euclidean rhythms (pulses spread as evenly as possible over steps) into a Session clip. layers: [{"pitch": 36, "pulses": 4, "steps": 16}, {"pitch": 42, "pulses": 7, "steps": 16, "rotation": 2}, {"pitch": 37, "pulses": 3, "steps": 8}] — different step counts make polyrhythms. Classics: 3/8 tresillo, 5/8 cinquillo, 7/16 samba, 5/16 bossa. Pitches are Drum Rack pads (36 kick, 38 snare, 42 hat).

transform_clipA

Develop a motif from a Session MIDI clip and write the result to another slot (default: the next empty slot below; the same slot overwrites the source). Operations, all staying in the key: invert, retrograde, augment, diminish (amount = factor, default 2), transpose (amount = scale steps), sequence (repeats copies, each amount steps higher), additive (minimalist build-up), displace (amount = beats). key/scale default to the song's scale.

find_progressionsA

The progression library (45 named progressions): search by name, genre or mood — "pop", "sad", "mizrahi", "jazz", "house", "cinematic", "israeli"... Empty query lists them all. Play one with write_named_progression.

write_named_progressionC

Write a progression from the library (find_progressions) in any key, e.g. name="andalusian", key="A" -> Am G F E. style: close, open, spread, drop2, shell, rootless, quartal.

als_summaryA

Summarise a saved Live Set without opening Live: tempo, time signature, length, locators, scenes, every track with its devices and clips, returns, plug-ins used. path = an .als file or a project folder (newest set). detail=True includes full device trees and every clip.

als_lintA

Check a saved Live Set before sharing, mixing or archiving: missing samples, plug-ins missing or not installed here, uncollected files, tracks routed nowhere, soloed or muted tracks, MIDI without an instrument, faders above +6 dB, default names, no locators. Errors first.

als_diffA

What changed between two versions of a Live Set: tempo, tracks added/removed/renamed, fader, mute, routing and device changes, clips and note counts, locators, scenes, plug-ins. With only old_path: compares the newest copy in the project's Backup folder (old) with that set (new).

als_export_midiA

Export the MIDI clips of a saved Live Set as .mid files (one per clip, set tempo), with Live closed. track filters by track name; out_dir defaults to '/MIDI Export'. Also estimates the key.

preset_infoA

Look inside an .adg rack or .adv device preset: devices and chains, macro names and values, plug-ins and Max for Live devices it needs, and whether it needs Live Suite.

Prompts

Interactive templates invoked by user choice

NameDescription
start_a_songStart a new song: template, chords, bass, drums and a melody that fit together.
make_a_beatProgram drums: kit, groove, variation and fill.
mix_and_masterBalance, process and check the mix with real measurements (export -> listen -> fix loop).
analyze_and_improveReview a song: structure, arrangement, technical problems and mix, with concrete fixes.
prepare_for_collaborationGet a Live Set ready to send to another producer or a mixing engineer.
sound_designBuild a sound from installed instruments and effects.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.8/5.0

Scored across 148 tools

Disambiguation2/5

There are direct near-duplicate pairs (get_device_params vs get_device_parameters, set_device_param vs set_device_parameter) and many overlapping effect-loading paths (load_instrument_or_effect, insert_device, add_effect, load_plugin, load_browser_uri). Three separate progression-writing tools (write_chords, write_progression, write_named_progression) and multiple mixer/device-setting routes make tool selection error-prone.

Naming Consistency3/5

Most names are snake_case verb_noun, but noun-only tools (chords, song_starter, session_diff, preset_info, song_starter) and inconsistent verb choices break predictability. The _param vs _parameter duplication and mixed legacy/new naming further muddy the convention.

Tool Count1/5

148 tools is an extreme mismatch for a DAW-control server; even with broad Ableton functionality, the surface is far beyond a reasonable scope. Many niche tools (als_lint, als_diff, inspect_live_api, scan_plugin_catalog, save_plugin_layout) overwhelm the core workflow.

Completeness4/5

Coverage is very broad: tracks, clips, notes, mixer, devices, plug-ins, arrangement, browser, mixing, export, analysis, and songwriting are all represented. Only minor gaps (e.g., granular per-note editing and some clip lifecycle operations) keep it from perfect completeness.

Maintenance

ActivityNo data
ResponsivenessOutdated data