Get the current Ableton Live session state.

Returns tempo, time signature, track count, return track count, master track info, playback state, and loop settings.

Get the current song time position and undo/redo availability.

Returns current_song_time (in beats), can_undo, and can_redo.

Get all cue points (locators) in the song.

Returns a list of cue points with index, name, and time.

Set the session tempo in BPM.

Args: tempo: Tempo value between 20 and 999 BPM.

Start playing the Ableton Live session.

Stop playing the Ableton Live session.

Undo the last action in Ableton Live.

Redo the last undone action in Ableton Live.

Set the song time signature.

Args: numerator: Time signature numerator (e.g., 4 for 4/4). denominator: Time signature denominator (e.g., 4 for 4/4).

Set the loop region and on/off state.

Args: loop_on: Enable or disable looping. loop_start: Loop start position in beats. loop_length: Loop length in beats.

Set the current song time (playhead position) in beats.

Args: time: Position in beats to jump to.

Continue playback from the current position without restart.

Stop all playing clips in the session.

Capture recently played MIDI notes into a new clip.

Enable or disable the metronome.

Args: on: True to enable, False to disable.

Set the global groove amount.

Args: amount: Groove amount value (0.0 to 1.0).

Set the song scale root note and/or scale name (Live 12+).

Args: root_note: MIDI note number for the root (0=C, 1=C#, ..., 11=B). scale_name: Scale name (e.g., 'Major', 'Minor', 'Dorian').

Jump to the next cue point (locator).

Jump to the previous cue point (locator).

Jump to a specific cue point by index.

Args: index: Zero-based index of the cue point to jump to.

Set the MIDI recording quantization.

Args: value: Quantization enum value (0=None, 1=1/4, 2=1/8, 3=1/8T, 4=1/8+T, 5=1/16, 6=1/16T, 7=1/16+T, 8=1/32).

Set the clip trigger (launch) quantization.

Args: value: Quantization enum value (0=None, 1=1/8, 2=1/4, 3=1/2, 4=1 Bar, 5=2 Bars, 6=4 Bars, 7=8 Bars).

Trigger session record in Ableton Live.

Tap tempo to set the BPM by tapping.

Get information about the currently selected track.

Returns the index, name, type, mute/solo/arm state, and color of the selected track.

Set the selected track in Ableton Live.

Args: track_index: Zero-based index of the track to select.

Get information about the currently selected scene.

Returns the index, name, and color of the selected scene.

Set the selected scene in Ableton Live.

Args: scene_index: Zero-based index of the scene to select.

Get properties of a specific scene.

Returns the scene name, tempo (-1.0 if not set), color, color_index, and (Live 12+) tempo_enabled, time_signature_numerator/denominator/enabled.

Args: scene_index: Zero-based index of the scene.

Set the tempo for a specific scene.

Pass 0 or a negative value to clear the scene tempo (scene will inherit the song tempo).

Args: scene_index: Zero-based index of the scene. tempo: Tempo in BPM, or -1.0 to clear.

Set the time signature for a specific scene (Live 12+).

Args: scene_index: Zero-based index of the scene. numerator: Time signature numerator (e.g., 4 for 4/4). denominator: Time signature denominator (e.g., 4 for 4/4).

Get Ableton Live application version info.

Returns major_version, minor_version, and bugfix_version.

Get LiveMCP remote-script transport capability information.

Get local install state and remote-script capability status.

Returns package version, client transport version, local install status, remote-script capability info when reachable, and actionable warnings.

Summarize whether Ableton is ready for flagship plugin validation.

Returns remote reachability, selected track/device state, Max bridge availability, and suggested next steps for Live-side or Max-side QA.

Confirm that the intended comparison device is the current Ableton selection.

Provide at least one expected selector. Track and device names match case-insensitively after trimming whitespace.

Get information about the current Ableton dialog box.

Returns open dialog count, current dialog message, and current dialog button count.

Press a button in the current Ableton dialog box.

Args: index: Zero-based button index in the current dialog.

Get Ableton application's average and peak CPU usage.

Get the canonical Ableton view names accepted by view control tools.

Get whether an Ableton view is currently visible.

Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.

Show an Ableton UI view.

Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.

Hide an Ableton UI view.

Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.

Show and focus an Ableton UI view.

Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.

Toggle Ableton's browser hot-swap mode for the selected device.

Get whether arrangement recording is armed.

Returns record_mode (True if armed, False otherwise).

Get Ableton Link and Tempo Follower state.

Enable or disable Ableton Link.

Args: enabled: True to enable Link, False to disable it.

Enable or disable Ableton Link Start/Stop Sync.

Args: enabled: True to enable Start/Stop Sync, False to disable it.

Enable or disable Tempo Follower.

Args: enabled: True to enable Tempo Follower, False to disable it.

Get metronome count-in settings and current counting-in state.

Get Session Record state and current record status.

Enable or disable Session Record.

Args: enabled: True to enable Session Record, False to disable it.

Enable or disable arrangement recording.

Args: enabled: True to arm recording, False to disarm.

Capture currently playing clips into a new scene.

Creates a new scene containing all currently playing session clips.

Create a cue point (locator) at the current playhead position.

IMPORTANT: You must call set_song_time first to position the playhead at the desired location, then call create_locator. The locator is always created at the playhead position, not at an arbitrary time.

Delete a cue point (locator) by index.

Due to Ableton API limitations, deletion may require two calls:

1. First call positions the playhead at the cue point's time.

2. Second call actually deletes the cue point. Check the 'deleted' field in the response.

Args: index: Zero-based index of the cue point to delete.

Get the current view state in Ableton Live.

Returns the selected track, detail clip (if any), draw mode, and follow song state.

Get the currently selected device on the selected track.

Select a device on a track in Ableton's UI.

Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device in the track's device chain.

Get the currently selected Ableton device parameter.

Get the currently selected rack chain in Ableton's UI.

Enable or disable Follow Song mode (auto-scroll to follow playhead).

Args: enabled: True to enable, False to disable.

Enable or disable Draw Mode for editing in Ableton Live.

Args: enabled: True to enable, False to disable.

Select a clip and show it in the Detail View.

Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.

Get the punch in/out state.

Returns whether punch_in and punch_out are enabled.

Enable or disable punch in for recording.

Args: enabled: True to enable punch in, False to disable.

Enable or disable punch out for recording.

Args: enabled: True to enable punch out, False to disable.

Re-enable automation that was overridden by manual parameter changes.

When you manually adjust an automated parameter, the automation is overridden. This re-enables all overridden automation.

Get whether session automation recording is enabled.

Returns session_automation_record (True if enabled).

Enable or disable session automation recording.

When enabled, parameter changes during playback are recorded as automation.

Args: enabled: True to enable, False to disable.

Display a message in the Ableton Live status bar.

Args: message: Text to display in the status bar.

Get session metadata: modified state, current song time, song length, and CPU load.

Returns is_modified, current_song_time (beats), song_length (beats), and current_cpu_load (if available).

Get the current song time in SMPTE (timecode) format.

Returns hours, minutes, seconds, and frames.

Get detailed information about a specific scene.

Returns the scene name, color, tempo (if tempo_enabled), time signature (if available), is_empty flag (if available), and clip_count across all tracks.

Args: scene_index: Zero-based index of the scene.

Get all clips in a scene across all tracks.

Returns clip status for every track at the given scene index, including track name, whether a clip is present, clip name and color, and playing/recording/triggered state.

Args: scene_index: Zero-based index of the scene.

Get detailed information about a specific track.

Returns the track name, type, mute/solo/arm state, volume, pan, list of clip slots with clip info, and list of devices.

Args: track_index: Zero-based index of the track.

Create a new MIDI track in the session.

Args: index: Position to insert the track. Use -1 to append at the end.

Create a new audio track in the session.

Args: index: Position to insert the track. Use -1 to append at the end.

Set the name of a track.

Args: track_index: Zero-based index of the track. name: New name for the track.

Delete a track from the session.

Args: track_index: Zero-based index of the track to delete.

Get information about all return tracks in the session.

Returns a list of return tracks with name, mute, solo, volume, and pan.

Get the input and output routing configuration for a track.

Returns input/output routing type and channel display names, plus lists of all available input and output routing types.

Args: track_index: Zero-based index of the track.

Get group and fold information for a track.

Returns whether the track is foldable, whether it belongs to a group, its current fold state, and the group track name if grouped.

Args: track_index: Zero-based index of the track.

Duplicate a track.

Args: track_index: Zero-based index of the track to duplicate.

Duplicate a scene.

Args: scene_index: Zero-based index of the scene to duplicate.

Delete a scene from the session.

Args: scene_index: Zero-based index of the scene to delete.

Set the color of a track by color index.

Args: track_index: Zero-based index of the track. color_index: Ableton color palette index.

Set the name of a scene.

Args: scene_index: Zero-based index of the scene. name: New name for the scene.

Set the color of a scene by color index.

Args: scene_index: Zero-based index of the scene. color_index: Ableton color palette index.

Create a new return track in the session.

Delete a return track from the session.

Args: return_index: Zero-based index of the return track to delete.

Set the monitoring state of a track.

Args: track_index: Zero-based index of the track. state: Monitoring state (0=In, 1=Auto, 2=Off).

Set the input routing for a track.

Use get_track_routing to see available routing type names.

Args: track_index: Zero-based index of the track. routing_type_name: Display name of the desired input routing type. routing_channel_name: Display name of the desired input routing channel (optional).

Set the output routing for a track.

Use get_track_routing to see available routing type names.

Args: track_index: Zero-based index of the track. routing_type_name: Display name of the desired output routing type. routing_channel_name: Display name of the desired output routing channel (optional).

Fold or unfold a group track.

Args: track_index: Zero-based index of the group track. fold: 1 to fold (collapse), 0 to unfold (expand).

Get the freeze status of a track.

Args: track_index: Zero-based index of the track.

Returns whether the track is frozen and whether it can be frozen. Note: Freezing/flattening cannot be triggered via the API (read-only status).

Get summary information for all tracks at once.

Returns a list of all tracks with name, type, color, mute, solo, arm, is_foldable, is_grouped, device count, and clip count. Useful for getting a full session overview without making separate calls per track.

Get the output meter levels for a track.

Returns the current output meter level, left channel, and right channel values.

Args: track_index: Zero-based index of the track.

Get detailed status of a specific clip slot.

Returns playing, recording, and trigger state, color info, and clip details (name, length, color) if a clip is present.

Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.