Get current Ableton Live session info: tempo, time signature, track counts, and master track details.

Get detailed info about a track: name, type, mute/solo/arm state, volume, pan, clip slots, and devices.

Create a new MIDI track. Use index=-1 to append at the end.

Create a new audio track. Use index=-1 to append at the end.

Delete a track by index.

Delete all tracks except one. Useful for clearing a session before building a fresh arrangement. Returns the count of deleted tracks.

Rename a track.

Set track volume. Range: 0.0 (silence) to 1.0 (max).

Set track pan. Range: -1.0 (full left) to 1.0 (full right), 0.0 is center.

Mute or unmute a track.

Solo or unsolo a track.

Create an empty MIDI clip in a clip slot. Length is in beats.

Add MIDI notes to a clip. Each note is a dict with keys: pitch (0-127), start_time (beats), duration (beats), velocity (0-127, default 100), mute (bool, default false). By default this replaces all existing notes in the clip. Set append=true to keep existing notes and add the new ones on top.

Rename a clip.

Start playing a clip.

Stop a playing clip.

Read all MIDI notes from a session clip. Returns a list of notes with pitch, start_time, duration, velocity, and mute.

Get detailed info about a session clip: name, length, loop_start, loop_end, is_playing, is_recording.

Duplicate a session clip from one scene to another on the same track. The destination clip slot must be empty.

Delete a clip from a session clip slot.

Create a new empty scene. Use index=-1 to append at the end. Adds a new clip slot row across all tracks.

Delete a scene by index. Cannot delete the last scene.

Rename a scene (the label in the Master track column).

Fire all clips in a scene simultaneously.

Start session playback.

Stop session playback.

Set the session tempo in BPM.

Set the song's time signature (e.g. 4/4, 5/4, 7/8).

Trigger Ableton's undo. Safety net for destructive operations.

Browse Ableton's instrument and effect categories. category_type can be: all, instruments, audio_effects, midi_effects, sounds, drums, max_for_live.

List items at a browser path. Paths can start with a top-level category (e.g. 'Sounds/Bass', 'Instruments/Analog', 'Audio Effects/Reverb') or use a bare subcategory name (e.g. 'Bass'). Use get_browser_tree first to discover available categories.

Load an instrument or effect onto a track by its browser URI. Use get_browser_tree and get_browser_items_at_path to find URIs. Returns the loaded device_name so you can verify the correct device was loaded. Set clear_existing=true to remove all existing devices from the track before loading — recommended when replacing an instrument on a non-empty track. IMPORTANT: load instruments sequentially, not in parallel. Concurrent loads will fail or land on the wrong track.

Create a new MIDI track and load an instrument in a single operation. Faster than separate create_midi_track + load_instrument_or_effect calls. Use index=-1 to append at the end. Optionally set the track name. IMPORTANT: load instruments sequentially, not in parallel.

Load a drum rack and then load a specific kit into it. First loads the rack by URI, then navigates to kit_path to load the kit preset.

List all parameters of a device on a track. Returns device_name and a list of parameters with name, value, min, max.

Set a device parameter value. Value is clamped to the parameter's min/max range. Use get_device_parameters to discover available parameters.

Get all clips on the arrangement timeline for a track. Returns each clip's index, name, start_time, end_time, and length in beats. Requires Ableton Live 11+.

Create an empty MIDI clip on the arrangement timeline. start_time and length are in beats.

Delete a clip from the arrangement timeline. Use get_arrangement_clips to find the clip_index.

Duplicate an arrangement clip to a new position on the timeline. destination_time is in beats.

Read all MIDI notes from an arrangement clip. Returns a list of notes with pitch, start_time, duration, velocity, and mute.

Set MIDI notes on an arrangement clip. Replaces all existing notes. Each note is a dict with keys: pitch (0-127), start_time (beats), duration (beats), velocity (0-127, default 100), mute (bool, default false).

Set the playback cursor position in beats.

Get the arrangement loop brace position and length in beats.

Set the arrangement loop brace. start and length are in beats.

Switch playback from session view back to the arrangement. Stops all session clips and resumes arrangement playback.

Copy a session view clip to the arrangement timeline. destination_time is the position in beats where the clip will be placed.

Lay out session view scenes sequentially on the arrangement timeline. Takes a list of scene indices and places each scene's clips end-to-end starting from beat 0. Use this to build a full song structure from session view clips.