AbletonMCP

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)

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)

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

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)

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)

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)

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)

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 detailed information about the current Ableton session

Parameters:

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

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)

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)

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)

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)

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)

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

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)

Start playing the Ableton session.

Parameters:

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

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)

Stop playing the Ableton session.

Parameters:

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

Switch Ableton's main window to the Arrangement view.

Parameters:

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