Get the current tempo (BPM) of the Ableton session.

Set the tempo of the Ableton session.

Parameters:

• bpm: Tempo in beats per minute (e.g., 90.0, 122.0)

Start playing the Ableton session.

Stop playing the Ableton session.

Continue playing the Ableton session from the current position.

Start Session Record mode — records all Session View clip launches and parameter changes into Arrangement View. This is the key method for capturing real-time performances.

Jump to a specific position in the song.

Parameters:

• time_in_beats: Position in beats from the start

Enable or disable the metronome.

Parameters:

• enabled: True to turn on, False to turn off

Set the time signature.

Parameters:

• numerator: Top number (e.g., 4 for 4/4)

• denominator: Bottom number (e.g., 4 for 4/4)

Undo the last action in Ableton.

Redo the last undone action in Ableton.

Create a new audio track.

Parameters:

• index: Position to insert (-1 = end)

Create a new MIDI track.

Parameters:

• index: Position to insert (-1 = end)

Create a new return track (e.g., for reverb or delay sends).

Create a new scene.

Parameters:

• index: Position to insert (-1 = end)

Get comprehensive info about the current Ableton session — tempo, track count, etc.

Query bulk data about multiple tracks and clips.

Parameters:

• start_track: First track index (inclusive)

• end_track: Last track index (exclusive)

• properties: Space-separated list of properties, e.g., "track.name clip.name clip.length" Prefix with track., clip., or clip_slot.

Get detailed info about a specific track — name, volume, mute, solo, devices, etc.

Parameters:

• track_index: The track index (0-based)

Set track volume.

Parameters:

• track_index: The track index (0-based)

• volume: Volume level (0.0 = silence, 0.85 = 0dB, 1.0 = max)

Mute or unmute a track.

Parameters:

• track_index: The track index (0-based)

• muted: True to mute, False to unmute

Solo or unsolo a track.

Parameters:

• track_index: The track index (0-based)

• soloed: True to solo, False to unsolo

Set track panning position.

Parameters:

• track_index: The track index (0-based)

• pan: Pan position (-1.0 = hard left, 0.0 = center, 1.0 = hard right)

Set a track's send level (e.g., reverb or delay send).

Parameters:

• track_index: The track index (0-based)

• send_index: Send index (0 = Send A, 1 = Send B, etc.)

• value: Send level (0.0 to 1.0)

Arm or disarm a track for recording.

Parameters:

• track_index: The track index (0-based)

• armed: True to arm, False to disarm

Rename a track.

Parameters:

• track_index: The track index (0-based)

• name: New name for the track

Set track color.

Parameters:

• track_index: The track index (0-based)

• color: Color index (Ableton color palette, 0-69)

Fire (start playing) a clip in Session View.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

Stop a playing clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

Get detailed info about a clip — name, length, playing state, gain, pitch, etc.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

Set the name of a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• name: New clip name

Set the gain of a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• gain: Gain value (0.0 to 1.0)

Set the pitch transposition of a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• semitones: Pitch shift in semitones (e.g., -2, 0, 3)

Mute or unmute a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• muted: True to mute, False to unmute

Set the color of a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• color: Color index (Ableton color palette)

Get all MIDI notes in a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

Set MIDI notes in a clip (replaces existing notes).

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• notes: List of note dicts with keys: pitch, start_time, duration, velocity, mute Example: [{"pitch": 60, "start_time": 0.0, "duration": 1.0, "velocity": 100, "mute": false}]

Create a new empty MIDI clip in a clip slot.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

• length: Clip length in beats (default 4.0 = 1 bar in 4/4)

Delete a clip from a clip slot.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

Check if a clip slot contains a clip.

Parameters:

• track_index: The track index (0-based)

• clip_index: The clip slot index (0-based)

Fire (trigger) a scene — launches all clips in the scene's row.

Parameters:

• scene_index: The scene index (0-based)

Set the name of a scene.

Parameters:

• scene_index: The scene index (0-based)

• name: New scene name

Set the color of a scene.

Parameters:

• scene_index: The scene index (0-based)

• color: Color index (Ableton color palette)

Set the tempo for a specific scene (scene-based tempo changes).

Parameters:

• scene_index: The scene index (0-based)

• bpm: Scene tempo in BPM (0 = no tempo change)

List all devices (effects/instruments) on a track.

Parameters:

• track_index: The track index (0-based)

Returns device names and their indices for use with parameter tools.

List all parameters of a device with their indices and current values. Use this to discover parameter indices for set_device_parameter.

Parameters:

• track_index: The track index (0-based)

• device_index: The device index (0-based) from get_device_list

Get the current value of a specific device parameter.

Parameters:

• track_index: The track index (0-based)

• device_index: The device index (0-based)

• parameter_index: The parameter index (0-based) from get_device_parameters

Set a device parameter value. This is the core automation primitive — controls filter frequency, reverb dry/wet, compressor threshold, etc.

Parameters:

• track_index: The track index (0-based)

• device_index: The device index (0-based)

• parameter_index: The parameter index (0-based) from get_device_parameters

• value: New parameter value (typically 0.0–1.0 for most params)

Enable or disable a device (bypass).

Parameters:

• track_index: The track index (0-based)

• device_index: The device index (0-based)

• enabled: True to enable, False to bypass

Find a device parameter index by searching for a substring in the parameter name. Useful for discovering parameter indices without manually inspecting all params.

Parameters:

• track_index: The track index (0-based)

• device_index: The device index (0-based)

• name_substring: Part of the parameter name to search for (case-insensitive), e.g., "Frequency", "Dry/Wet"

Send a raw ClyphX Pro action string. Use this for any ClyphX command not covered by the specific ClyphX tools below.

Parameters:

• action_string: The ClyphX action string, e.g., '1/LOADDEV "Auto Filter"' Multiple actions can be chained with semicolons: '1/LOADDEV "Auto Filter" ; 1/LOADDEV "Reverb"'

Common actions: ADDAUDIO / ADDMIDI / ADDRETURN — create tracks {track}/LOADDEV "{name}" — load a device {track}/NAME "{name}" — rename track {track}/COLOR {n} — set track color {track}/VOL {n} — set volume (0-127) {track}/PAN {n} — set pan (0-127, 64=center) {track}/MUTE ON/OFF — mute/unmute {track}/SEND {letter} {n} — set send level {track}/IN "{name}" / OUT "{name}" — set routing BPM {n} — set tempo SIG {n}/{n} — set time signature METRO ON/OFF — metronome SREC — toggle session record

Load an Ableton device (effect/instrument) onto a track using ClyphX Pro. This is the KEY capability that AbletonOSC alone cannot do.

Parameters:

• track_number: Track number (1-based, as ClyphX uses 1-based indexing)

• device_name: Name of the Ableton device, e.g., "Auto Filter", "Reverb", "Chorus", "Saturator", "Glue Compressor", "EQ Eight", "Delay", "Compressor", "Utility"

Create a new audio track using ClyphX Pro.

Create a new MIDI track using ClyphX Pro.

Create a new return track using ClyphX Pro.

Set track routing using ClyphX Pro.

Parameters:

• track_number: Track number (1-based)

• input_source: Input routing source, e.g., "Ext. In"

• output_dest: Output routing destination, e.g., "Master"

• input_sub: Input sub-routing, e.g., "Post FX"

• output_sub: Output sub-routing, e.g., "Post FX"

Set multiple track properties at once using ClyphX Pro.

Parameters:

• track_number: Track number (1-based)

• name: Track name (empty = skip)

• color: Color index 0-69 (-1 = skip)

• volume: Volume 0-127 (-1 = skip)

• pan: Pan 0-127, 64=center (-1 = skip)

• mute: "ON" or "OFF" (empty = skip)

• arm: "ON" or "OFF" (empty = skip)

List all tracks with their names and indices. Useful for building a mental model of the current session layout.

List all clips in a track's Session View slots.

Parameters:

• track_index: The track index (0-based)

• max_slots: Maximum number of slots to check (default 20)

List all devices on a track with their parameters. Full device discovery for understanding what can be automated.

Parameters:

• track_index: The track index (0-based)

Test connectivity to both AbletonOSC and ClyphX Pro. Verifies that both bridges are working.

Smoothly ramp a device parameter from one value to another over a specified number of beats. This is used for filter sweeps, reverb builds, compression changes, etc.

Parameters:

• track_index: The track index (0-based)

• device_index: The device index (0-based)

• parameter_index: The parameter index (0-based)

• start_value: Starting parameter value

• end_value: Ending parameter value

• beats: Duration in beats

• bpm: Current tempo (default 95)

• steps_per_beat: Resolution of the ramp (default 6 steps per beat)

Smoothly ramp track volume over a specified number of beats. Used for fade-ins, fade-outs, and dynamic volume changes.

Parameters:

• track_index: The track index (0-based)

• start_volume: Starting volume (0.0–1.0)

• end_volume: Ending volume (0.0–1.0)

• beats: Duration in beats

• bpm: Current tempo (default 95)

• steps_per_beat: Resolution of the ramp (default 6)

Smoothly ramp a track's send level over a specified number of beats. Used for reverb/delay build-ups and decay.

Parameters:

• track_index: The track index (0-based)

• send_index: Send index (0 = Send A, 1 = Send B, etc.)

• start_value: Starting send level (0.0–1.0)

• end_value: Ending send level (0.0–1.0)

• beats: Duration in beats

• bpm: Current tempo (default 95)

• steps_per_beat: Resolution of the ramp (default 6)

Execute a "drop" — spike send levels for a reverb/delay wash tail, then mute all specified tracks. A common production technique for creating dramatic transitions.

Parameters:

• track_indices: List of track indices to drop (0-based)

• reverb_send_level: Reverb send level to spike to (default 0.95)

• delay_send_level: Delay send level to spike to (default 0.80)

Load multiple effects onto a track in sequence via ClyphX Pro. Each effect load requires a delay for Ableton to initialize it.

Parameters:

• track_number: Track number (1-based, ClyphX indexing)

• effects: List of effect names, e.g., ["Auto Filter", "Reverb", "Chorus", "Saturator"]

• delay_between: Seconds to wait between effect loads (default 0.5)

Build a complete session template — creates tracks, loads effects, sets names/colors/volumes, and configures tempo. This is the the quickest way to set up a new session.

Parameters:

• track_configs: List of track config dicts, each with:

  • name: Track name

  • color: Color index (optional, default -1)

  • effects: List of effect names to load (optional)

  • volume: Initial volume 0-127 (optional, default 80)

  • send_a: Send A level 0-127 (optional, default 0)

• bpm: Session tempo (default 90)

• time_sig: Time signature as "num/denom" (default "4/4")

Example track_config: {"name": "Sub/Pad", "color": 43, "effects": ["Auto Filter", "Reverb", "Chorus"], "volume": 80, "send_a": 40}

Wait for a specified number of beats. Useful for timing operations in a sequence of MCP tool calls.

Parameters:

• beats: Number of beats to wait

• bpm: Current tempo (default 95)

Delete a track by index. Parameters: track_index (0-based).

Delete a scene by index. Parameters: scene_index (0-based).

Duplicate a track. Parameters: track_index (0-based).

Duplicate a scene. Parameters: scene_index (0-based).

Stop all playing clips in the session.

Capture recently played MIDI notes into a new clip (Live 10+ feature).

Tap tempo — call repeatedly to set tempo by tap timing.

Jump to the previous cue point.

Jump to the next cue point.

Get all cue points in the session (name + time pairs).

Jump to a cue point by name or index. Parameters: name_or_index — cue point name (string) or index (number)

Set or delete a cue point at the current playback position.

Re-enable any automation that has been overridden by manual changes.

Enable or disable the arrangement loop. Parameters: enabled (bool).

Set the arrangement loop start position in beats.

Set the arrangement loop length in beats.

Enable or disable arrangement overdub.

Set the global groove amount (0.0 to 1.0).

Enable or disable punch in.

Enable or disable punch out.

Toggle arrangement record mode.

Set session record state directly (vs trigger_session_record which toggles).

Get the total number of tracks.

Get the total number of scenes.

Get names of tracks in range. -1 for end means all tracks.

Export full song structure (tracks, clips, devices, parameters) to a temp JSON file.

Set the clip trigger quantization. 0=None, 1=8bars, 2=4bars, 3=2bars, 4=1bar, etc.

Capture the currently playing clips into a new scene.

Set track monitoring state. 0=IN, 1=AUTO, 2=OFF. Parameters: track_index (0-based), state (0/1/2)

Fold or unfold a group track. Parameters: track_index (0-based), folded (bool).

Delete a device from a track. Parameters: track_index, device_index (0-based).

Stop all clips on a specific track. Parameters: track_index (0-based).

Get the current output meter level of a track (for visual feedback).