Ableton Studio MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ABLETON_MCP_HOST | No | The host the Ableton control surface listens on. It listens on localhost only by default; set this deliberately to change that. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_session_infoA | Overview of the Live set: tempo, time signature, track and return counts, main track, transport state, song length and loop. |
| get_remote_script_infoA | Version and command list of the AbletonStudioMCP control surface running
in Live, compared with this server. Use it when tools say Live is too old
or not responding ( |
| get_session_snapshotA | Everything in the set at once: every track with its mixer, devices, Session and Arrangement clips, plus scenes, returns, the main track and locators. Handy to compare the set before and after a series of edits. Parameters:
|
| set_tempoB | Change the song tempo. Parameters:
|
| start_playbackA | Start the transport (plays from the playhead). |
| stop_playbackC | Stop the transport. |
| switch_to_arrangement_viewB | Bring Live's Arrangement view to the front. |
| set_arrangement_timeB | Move the playhead. Parameters:
|
| create_locatorA | Put a named locator in the Arrangement. A locator already at that beat is renamed rather than removed. Playback must be stopped. Parameters:
|
| delete_locatorA | Remove a locator, found by position (exact) or by name. When several locators share the name nothing is removed and their positions are listed. Playback must be stopped. Parameters:
|
| get_scenesA | List the Session scenes with their index, name and tempo. |
| create_sceneB | Add an empty scene. Parameters:
|
| delete_sceneB | Remove a scene together with every clip in its row. Ask the user first. Parameters:
|
| duplicate_sceneB | Copy a scene and its clips; the copy goes right below it. Parameters:
|
| fire_sceneC | Launch every clip in a scene's row. Parameters:
|
| set_scene_nameC | Rename a scene. Parameters:
|
| undoA | Undo the last change(s) in Live, like Cmd/Ctrl+Z. Each tool call that changed the set is one step; tools that make many changes at once (drum patterns, progressions, arrangements, MIDI imports…) are one step too, as is everything between start_undo_group and end_undo_group. It is Live's own Undo: if the user edited the set meanwhile, their change comes first. Parameters:
|
| redoA | Redo what undo just took back (as long as nothing else changed since). Parameters:
|
| start_undo_groupA | Start grouping: every change until end_undo_group becomes a single undo step, so a whole request ("8 bars of techno with a bassline") can be taken back at once. Always call end_undo_group afterwards; a group left open is closed automatically after two minutes. Parameters:
|
| end_undo_groupB | Close the undo group opened with start_undo_group. |
| get_track_infoB | One track in detail: name, mixer state, clip slots and device chain. Works for return tracks and the main track too. Parameters:
|
| create_midi_trackB | Add a MIDI track (for instruments and drum racks). Parameters:
|
| create_audio_trackC | Add an audio track (for samples, stems, recordings). Parameters:
|
| set_track_nameC | Rename a track. Parameters:
|
| delete_trackA | Remove a track and everything on it. Ask the user first. Tracks after it move up one index. Parameters:
|
| duplicate_trackA | Copy a track with its clips and devices; the copy goes right after it. Parameters:
|
| set_track_volumeA | Move a track's fader. Parameters:
|
| set_track_panningB | Pan a track. Parameters:
|
| set_track_sendB | Set how much of a track goes to a return track. Parameters:
|
| set_track_muteB | Mute or unmute a track. Parameters:
|
| set_track_soloC | Solo or unsolo a track. Parameters:
|
| set_track_armB | Arm a track for recording, or disarm it. Parameters:
|
| create_clipA | Make an empty MIDI clip in a Session slot (the slot must be empty). Parameters:
|
| create_audio_clipA | Put an audio file into an empty Session slot of an audio track (Live 12.0.5 or newer). Parameters:
|
| set_clip_nameC | Rename a Session clip. Parameters:
|
| set_arrangement_clip_nameA | Rename a clip in the Arrangement. Parameters:
|
| delete_clipC | Empty a Session slot (create_clip refuses occupied slots). Parameters:
|
| delete_arrangement_clipA | Remove a clip from the Arrangement. Later clips on the track move down one index. Parameters:
|
| fire_clipC | Launch a Session clip. Parameters:
|
| stop_clipC | Stop a playing Session clip. Parameters:
|
| get_clip_notesA | All the MIDI notes of a clip: pitch, start_time, duration, velocity, mute (plus probability and velocity deviation when Live has them). Times are in beats from the clip start. For an Arrangement clip the reply also has arrangement_start / arrangement_end and start_marker: without looping, a note sounds at arrangement_start + (start_time − start_marker). Parameters:
|
| add_notes_to_clipA | Add notes to a clip; existing notes stay. To replace notes, clear the clip (clear_notes_from_clip) or a range (remove_notes) first. Parameters:
|
| clear_notes_from_clipA | Remove every note from a clip. Together with get_clip_notes and add_notes_to_clip this gives read → edit → write: read the notes, change the list, clear the clip, add the new list. For part of a clip use remove_notes. Parameters:
|
| remove_notesA | Remove only the notes starting inside a time window and a pitch range — to rewrite one bar, or one drum lane, then add the new notes. Parameters:
|
| get_arrangement_clipsB | The clips a track has in the Arrangement, in time order, with their position, length and type. Their order is the clip_index other tools use. Parameters:
|
| duplicate_to_arrangementA | Copy a Session clip into the Arrangement, on the same track. Repeat the call for every place the clip should play, then switch_to_arrangement_view to look at the result. Parameters:
|
| get_clip_loopB | A clip's loop switch, loop brace and start/end markers, and what actually plays. Beats, except seconds for an unwarped audio clip ("units" says which). Arrangement clips also report their place in the song. Parameters:
|
| set_clip_loopA | Change a clip's loop and markers; anything left out stays as it is. With looping on, playback starts at start_marker and then repeats the brace (loop_start → loop_end); e.g. keep only the first bar of a 4-bar loop with loop_start=0, loop_length=4. With looping off Live plays loop_start → loop_end once, so markers given for such a clip are written to the brace. The writes are ordered so the start never passes the end; the reply shows what Live applied and lists any value it "adjusted". Switching warping off and on again resets an audio clip's warp markers. Parameters:
|
| get_clip_warpC | An audio clip's warp state: warping, warp mode (and the modes on offer), warp markers (beat_time ↔ sample_time in seconds), transposition, gain, clip length and file duration. Parameters:
|
| set_clip_warpA | Change an audio clip's warp settings; anything left out stays as it is. Give a loop's own tempo as original_bpm (sample names often carry it, "...131...") and it follows the song tempo: warping goes on and the warp markers are rebuilt for that tempo. Parameters:
|
| edit_warp_markersA | Edit the warp markers of a warped audio clip (Live 11+), in this order: remove, then move, then add. get_clip_warp shows the current ones. Parameters:
|
| set_clip_automationA | Draw an automation envelope inside a Session clip; it plays whenever the clip plays. (Live's API does not allow writing envelopes in Arrangement clips or the Arrangement's automation lanes.) Target a device parameter (device_index + parameter_index, see get_device_parameters) or a mixer control (mixer_parameter). Parameters:
|
| get_clip_automationB | Read a clip's envelope for one parameter, sampled every Parameters:
|
| get_device_parametersA | Every parameter of a device with its index, value, range and the value as Live displays it (dB, Hz, %, mode names). Parameters:
|
| set_device_parameterA | Change one device parameter. Look up indexes and ranges with get_device_parameters; the reply shows the old and new values as Live displays them. Parameters:
|
| device_inventoryA | Everything loaded in the set — every device on every track, return track and the main track, racks with their chains — with what each one is and what it is for (native devices from the Live 12 manual, Max for Live devices, known plug-in families such as Arturia emulations), plus, with installed_plugins=true, the VST/VST3/AU plug-ins installed, by vendor. Parameters:
|
| device_knowledgeB | What a device does: a native Live device (from the Live 12 manual: kind,
category, purpose, key parameters, electronic/techno uses, sidechain,
tip), a bundled Max for Live device, or a known plug-in (e.g. "Acid V",
"Comp FET-76", "Cthulhu"). Without Parameters:
|
| get_device_infoB | One device's identity (Live's real device name even when a preset renamed it, kind, latency) and its specific API: sidechain routing and options (Compressor), plug-in presets, Simpler sample/slicing state, rack chains and variations. Parameters:
|
| set_device_sidechainA | Feed a Compressor's sidechain from another track (e.g. duck the bass or
pads with the kick) and switch its sidechain on. Parameters:
|
| plugin_presetsA | A VST/AU plug-in's preset list (as the plug-in exposes it to Live), or select one by index or name (exact, else first containing the text). Parameters:
|
| simpler_sampleB | Load a sample into a Simpler and set it up: playback mode (classic, one_shot, slicing), slicing by transient / beat / region / manual with sensitivity, beat division or region count (e.g. chop a break into 16 slices playable from a Drum Rack-like MIDI layout), voices, warp the sample as N beats, crop, reverse. Parameters:
|
| rack_variationA | A rack's macro variations (Live 11+): list them with the current macro values, recall one, store the current macros as a new variation, or randomize the macros (great for happy accidents, then store the result). Parameters:
|
| set_drum_chokeA | Put Drum Rack pads in a choke group so they cut each other — the classic: closed and open hi-hat together (e.g. notes [42, 46], group 1). Group 0 removes the choke. Parameters:
|
| get_browser_treeA | The folders of Live's browser, as an indented outline with the path of each folder (use the paths with get_browser_items_at_path). Parameters:
|
| get_browser_items_at_pathA | What a browser folder contains, with each item's URI and whether it can be loaded (load it with load_instrument_or_effect). Parameters:
|
| load_instrument_or_effectA | Load a browser item — instrument, effect, preset, plug-in, User Library file — onto a track, by its URI. Effects can also go on a return track (track_type="return", track_index 0 = A) or on the main track (track_type="master"). Find URIs with get_browser_items_at_path. Parameters:
|
| load_drum_kitC | Load a Drum Rack, then the first loadable kit found in a browser folder. Parameters:
|
| get_track_routingA | Read a track's input/output routing and monitoring, with the options Live offers for each (names as shown in Live's I/O section, in Live's language). Parameters:
|
| set_track_routingA | Set a track's input/output routing and monitoring. Arguments left out are untouched. Names are matched against the options get_track_routing lists: exact (case-insensitive) first, else a unique substring. Examples:
Parameters:
|
| record_arrangementA | Record the armed tracks into the Arrangement between two song positions (in beats): moves the playhead, turns Arrangement Record on, plays, and stops at end_time. Arm tracks first (set_track_arm). Parameters:
|
| get_recording_statusB | State of the current or last record_arrangement run (finished, reason, stop position), plus Arrangement Record, transport and armed tracks. |
| stop_arrangement_recordingA | Stop a running record_arrangement now (turns Arrangement Record off and stops playback). |
| get_audio_clip_fileB | Path of the audio file behind an audio clip (for example a take just recorded with record_arrangement), with its length and sample rate. Parameters:
|
| analyze_audio_fileA | Measure a WAV or AIFF file: peak and RMS levels (dBFS), clipping, crest factor, loudness over time (one value per segment), leading/trailing silence, stereo correlation and a coarse spectral balance (low < 250 Hz, mid, high > 4 kHz), with warnings. Use it to check a mix or a recorded take. Parameters:
|
| get_track_metersA | Live's output meters right now for every track, return track and the main track (0.0-1.0 on Live's meter scale, as in the mixer). Meaningful while the song plays; listen_to_arrangement samples them for you. |
| analyze_mixA | Mastering-engineer report on a WAV/AIFF mix: loudness per ITU-R BS.1770 / EBU R128 (integrated, short-term and momentary max, loudness range), true peak (4x oversampled), PLR, crest factor, long-term 1/3-octave spectrum with tilt and per-region deviation from a balanced -4.5 dB/oct reference (mud, harshness, sibilance, air, sub), narrow resonances (with note names), stereo correlation and width overall and per band (low-end mono), DC. Returns findings ranked problème / attention / ok with concrete fixes against the delivery target, plus a spectrogram image (log frequency, with the short-term loudness curve) to look at. Parameters:
|
| listen_to_arrangementA | "Listen" to the song like a mastering engineer: record the main output between two song positions (beats) onto a temporary resampling audio track, sample every track's meter during the take, then analyze it. report="mix" (default) returns the full analyze_mix report (LUFS, true
peak, PLR, tonal balance, resonances, stereo, findings with fixes against
Parameters:
|
| import_midi_fileA | Import the notes of a Standard MIDI File (.mid) into a clip. Without track_index, only describes the file (tracks, note counts, channels, length) so you can pick midi_track / channel first. Session: an empty slot gets a new clip as long as the notes (rounded up to a 4-beat bar) or clip_length; an existing clip receives the notes (after clearing it when replace=True). Arrangement: the clip must exist (index from get_arrangement_clips). Times are in beats; the file's tempo is ignored. Parameters:
|
| music_scalesA | Scales and modes knowledge. Without arguments, lists all ~50 scales
(church modes, harmonic/melodic minor families, pentatonics, blues,
bebop, symmetric, Japanese, gamelan, flamenco...) with their character
and typical styles; Parameters:
|
| music_stylesA | Style sheets for composing or re-arranging: without Parameters:
|
| music_chord_ideasA | Reharmonisation ideas for a chord (tritone substitution, ii-V preparation, relative chords, extensions, borrowed chords in the key), with the reason for each, plus the chord's notes. Parameters:
|
| analyze_clip_musicA | Musical analysis of a MIDI clip: key and mode candidates (with coverage and outside notes; relative modes are told apart by the harmony, e.g. a V7 pointing to its tonic), chords per segment with roman numerals, out-of-scale notes, range, rhythm (density, offbeat share, polyphony) and melodic motion of the top line. Also reports Live's song scale. Parameters:
|
| transform_clipA | Re-arrange a MIDI clip with a chain of music-theory operations, applied in
order. Writes the result back into the clip, or into an empty Session slot
Each operation is {"op": name, ...arguments}:
Parameters:
|
| write_progressionA | Write a chord progression into an empty Session slot (clip created to fit) or an existing clip, voiced with smooth voice leading and played with an accompaniment pattern. Give Parameters:
|
| get_song_scaleA | Live 12's song scale: root, scale name, intervals and the Scale Mode switch (which highlights the scale in the piano roll and drives devices set to "Use Current Scale", e.g. the Scale, Arpeggiator and Chord devices). |
| set_song_scaleA | Set Live 12's song scale so the piano roll shows it and scale-aware
devices follow it. Parameters:
|
| drum_patternsA | Drum pattern library for electronic music. Without arguments, lists the
styles (techno_four, techno_rolling, techno_hypnotic, minimal_techno,
dub_techno, hard_techno, acid_techno, detroit_techno, house_classic,
deep_house, tech_house, afro_house, uk_garage, breakbeat, electro,
drum_and_bass, dubstep, trap, ebm). With Grid language (one string per role, 16 steps = one bar of 16ths): x hit · X accent · o ghost · . rest · 2 3 4 ratchet · ? 50 % chance · * 25 % chance ghost. Parameters:
|
| get_drum_mapA | The Drum Rack on a track: every filled pad (MIDI note, name, devices) and the role each one plays (kick, clap, closed_hat, open_hat, rim, ride, perc...), read from the pad names, as used by write_drum_pattern. Parameters:
|
| write_drum_patternA | Program drums into a Session slot (clip created to fit) on a track with a Drum Rack. Roles are mapped to the kit's pads by their names (a similar free pad stands in for a missing role; missing ones are reported); without a Drum Rack, General MIDI notes are used. Start from a library Parameters:
|
| get_groove_poolA | Live's Groove Pool: the grooves loaded in the set (name, base, timing, random, velocity and quantization amounts) and the global Groove amount. Grooves live in the browser under Packs (e.g. get_browser_items_at_path("packs/Core Library/Grooves")) and in the User Library; apply one with set_clip_groove. A groove only acts when the global amount is above 0 (set_groove_params global_amount). |
| set_clip_grooveA | Apply a Groove Pool groove to a clip (Live's own swing/groove engine, non-destructive), or remove it with groove_index omitted. Parameters:
|
| set_groove_paramsA | Adjust a groove in the Groove Pool (amounts in %, as in Live) and/or the global Groove amount (0-1.3, i.e. 0-130 %). Parameters:
|
| arrangement_templatesA | Arrangement templates for electronic music and the automation curve
shapes. Without Parameters:
|
| write_clip_evolutionA | Make a Session clip evolve over many bars: optionally extend it to Each lane: {"mixer_parameter": "volume" | "panning" | "send:N"} or {"device_index": d, "parameter_index": p}, plus "start", "end" (in the parameter's units, see get_device_parameters: min/max/display), "shape" (linear, exp, log, s_curve, swell, sine, triangle, steps, random_walk, hold), optional "cycles" (sine/triangle), "steps" (steps), "power" (exp/log curvature, default 2.5), "from_bar"/"to_bar" to limit the curve to part of the clip (the value holds outside), "seed". Example, a 64-bar techno build: filter cutoff exp from 0.3 to 0.9, reverb send swell, hats volume in 8 steps. Parameters:
|
| build_arrangementA | Build the Arrangement from Session clips, section by section, like a producer laying out a track: each section plays the clips of the tracks whose role is active there, tiled to fill it, with a named locator at its start. Clip envelopes (see write_clip_evolution) come along as track automation, so a filter build or a reverb swell plays in the Arrangement. Use a Parameters:
|
| arrangement_overviewB | A map of the Arrangement: for every track, one character per block of
Parameters:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 96 tools
Most tools map to a distinct DAW object or action, and detailed descriptions disambiguate close pairs such as set_clip_automation vs write_clip_evolution and analyze_audio_file vs analyze_mix. There are still several near-overlapping analysis, knowledge, and device-inspection tools, but clear boundaries generally exist.
Most action tools use a consistent snake_case verb_noun pattern (get_, set_, create_, delete_, write_, build_), while informational catalog tools use noun phrases (device_inventory, music_styles). The deviations are minor and readable.
96 tools is far beyond a practical tool set and well past the 25+ 'too many' threshold, even for a deep DAW controller. Many related operations could be consolidated, and the volume increases selection risk.
The surface covers session control, tracks, clips, MIDI editing, devices, browser access, routing, recording, mix analysis, and music generation/arrangement in depth. Remaining gaps are relatively minor, such as return-track lifecycle and device-chain reordering/deletion.