Skip to main content
Glama

Ableton AI

Control Ableton Live from an AI assistant like Claude. You describe what you want in plain language, and it builds it in your Live set: tracks, instruments, effects, MIDI clips, automation, and mixing. Over 150 commands covering most of the Live Object Model.

You describe, it builds, you listen and judge. The assistant has no ears, so it handles the mechanical work while you keep the taste.

Contents

Related MCP server: Ableton MCP Extended

What you can do with it

Ask for a sound and get it built:

Build a dark ambient pad on a new track. Slow attack, long release,
a filter behind it with a slow LFO on the cutoff. Play a minor chord.

Ask for the tedious things you'd never do by hand:

Write six clips at 3, 5, 7, 11, 13 and 17 bar lengths. They're coprime,
so the loop won't repeat for over a million bars.
Draw a twelve minute filter sweep with 200 automation points, then put
per-note probability on the hats so they flicker instead of repeating.

Ask for a whole piece in a style:

Lay down a Steve Reich style phasing piece. Two piano tracks play the same
short cell; make one clip a bar longer than the other so they drift out of
phase and slowly pull back into sync. Add a marimba and a vibraphone doubling
fragments of the cell at their own loop lengths, so the parts interlock and
never quite repeat.

Ask it to fix what you just heard:

The bass is too quiet and the reverb is too wet. Pull them back.

How it works

The assistant talks to Ableton through the Model Context Protocol (MCP), an open standard for giving AI tools access to external systems. This project is an MCP server that exposes Ableton's Live Object Model as a set of tools the assistant can call.

There are two pieces:

The MCP server runs on your machine as its own process. Your AI client (Claude Code, Claude Desktop, Cursor) launches it and calls its tools.

A remote script runs inside Ableton itself. Ableton's Control Surface system lets you run Python inside Live, and that script opens a local socket the MCP server talks to. This is the only supported way into Live's API, so it has to be Python and it has to be enabled in Ableton's settings.

When you ask for something, the assistant calls a tool, the server sends a command over the socket, the remote script runs it against Live's API, and the result comes back. You see it happen in Ableton in real time.

Installation

You need Ableton Live 11 or newer, and uv.

First, install the remote script into Live. This is the part that runs inside Ableton:

uvx --from ableton-ai install-remote-script

Then connect your AI client.

For Claude Code:

claude mcp add ableton -s user -- uvx ableton-ai

For Claude Desktop, add this to claude_desktop_config.json (find it under Settings, Developer, Edit Config):

{
  "mcpServers": {
    "ableton": {
      "command": "uvx",
      "args": ["ableton-ai"]
    }
  }
}

Restart your AI client after either one, so it picks up the new server.

Finally, turn the remote script on in Ableton. Open Settings, then Link, Tempo & MIDI. Under Control Surface, pick AbletonAI. Leave Input and Output on None.

Ableton's status bar should flash AbletonAI: Listening for commands on port 9877. If it doesn't, the remote script isn't installed, so rerun the first step and restart Live.

Getting started

Open a Live set you don't mind messing up, then hand your assistant this:

You're controlling my Ableton Live set. You can't hear anything you make,
so don't tell me it sounds good. Build what I ask, read the settings back
to check they landed, and let me be the judge.

Some things in Live are dropdowns you can't set through the API: the LFO
Map button, a Compressor's sidechain source, Drift's mod matrix routing.
If you need one of those, tell me and I'll click it.

To start: make a MIDI track, load Drift, and build an ambient pad with a
slow attack and long release. Add a filter behind it with a slow LFO on
the cutoff. Play a minor chord and loop it.

That first paragraph is worth keeping around. It saves you re-explaining the same things every session. Better still, install the skill below, which teaches your assistant all of this and more.

The skill

If you use Claude Code, there's a skill in skills/ableton that teaches the assistant how to use these tools well: the parameter names each command expects, how to verify a change actually landed, how to reach inside drum racks, and how to build generative patches with coprime loops and note probability.

Install it:

mkdir -p ~/.claude/skills
cp -R skills/ableton ~/.claude/skills/

Restart Claude Code. It picks the skill up whenever you ask for something musical.

Using a local model instead of Claude

If you'd rather not use an MCP client, there's an HTTP server that exposes the same commands. That lets you drive Ableton from a local model like Ollama, or from anything that can make an HTTP request.

This server lives in the git checkout, so clone the repo first and install the optional rest extra:

uv sync --extra rest

Start it in its own terminal:

uv run python rest_api/rest_api_server.py

It listens on http://127.0.0.1:8000. Every command is a POST to /api/command with a command and its params, the same names the tools use. For example, creating a MIDI track:

curl -X POST http://127.0.0.1:8000/api/command \
  -H "Content-Type: application/json" \
  -d '{"command": "create_midi_track", "params": {"index": -1}}'

To wire it to a local model, give the model a tool that posts to that endpoint, then let it fill in the command and params. A minimal loop in Python:

import requests

def ableton(command, params=None):
    return requests.post(
        "http://127.0.0.1:8000/api/command",
        json={"command": command, "params": params or {}},
    ).json()

ableton("set_tempo", {"tempo": 124})
ableton("create_midi_track", {"index": -1})

GET /api/commands lists every command the server accepts, and GET /health tells you whether Ableton is connected. The server needs the remote script installed and enabled, same as the MCP path.

Editing the remote script

If you change the remote script, Ableton needs a restart to load it, because Live caches the compiled bytecode. Save your set, copy the updated file into place, and restart Live. Toggling the Control Surface off and on is not reliable.

Safety

The remote script opens an unauthenticated socket on localhost:9877. It isn't reachable from the network, but any process running as you can drive Ableton through it.

The more practical point: the assistant has over 150 commands, many of which change your project, and it can't hear what it's doing. It will occasionally clear something you cared about. Work on copies, save often, and lean on Cmd+Z, which covers most operations.

Testing

uv sync --all-extras
uv run pytest
uv run ruff check src tests
uv run mypy

Architecture

If you want to work on this, here's how the parts fit together. The earlier "How it works" section is the short version; this is the longer one.

There are two processes, and they don't share memory. The first is the MCP server, a normal Python package under src/ableton_ai. The second is the remote script under remote_script, which runs inside Ableton's own embedded Python interpreter. They talk to each other over a TCP socket on localhost:9877, passing JSON back and forth. That socket is the whole interface between them.

The MCP server is the side your AI client talks to. server.py builds a FastMCP server and registers every tool. The tools live in src/ableton_ai/tools, split by what they touch: tracks, clips, notes, devices, browser, automation, arrangement, session, and a few musical helpers. Each tool is a small function decorated with @tool, which registers it and wraps it in uniform error handling, so a tool body is usually two lines: send a command, format the result. None of the tools hold state. They all go through one shared AbletonConnection in connection.py, which owns the socket and serializes every exchange behind a lock, because the socket handles one command at a time.

The remote script is the side that can actually touch Live. Ableton's Control Surface system is the only supported way to run code inside Live and reach its API, and it only runs Python, which is why this half is Python no matter what. When Live loads the script, it opens the socket and waits. A command comes in as JSON, the script looks it up, runs it against Live's API, and sends the result back.

The one subtlety worth knowing is threading. The socket runs on a background thread, but Live's API can only be touched safely from Live's main thread. So any command that changes something (creating a track, setting a parameter, writing notes) is put on a queue and run on the main thread, while read-only commands can answer straight from the socket thread. This isn't decoration. A state change made from the wrong thread crashes Live outright, which is a mistake this codebase has made and fixed.

A single request, end to end: you ask for a track, the assistant calls the create_midi_track tool, the server sends {"type": "create_midi_track", ...} over the socket, the remote script queues it onto Live's main thread, Live makes the track, the result travels back through the socket to the tool, and the tool returns a sentence the assistant reads. You see the track appear in Ableton as it happens.

The last piece is rest_api, an optional HTTP server that exposes the same commands to clients that don't speak MCP, like a local Ollama model. It's not needed for the Claude workflow and you can ignore it unless you want it.

Credits

Built on the original AbletonMCP by Siddharth Ahuja and later work by Jason Poindexter, with thanks to calclavia and Ronbalt.

License

MIT. See LICENSE.

Available Tools

157 tools
add_notes_to_clipB

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

Inputs: notes (required), clip_index (required), track_index (required).

add_notes_with_probabilityA

Add MIDI notes carrying per-note probability and velocity deviation.

Prefer this over add_notes_to_clip for anything generative. Plain add_notes_to_clip uses Live's legacy API, which has no probability field and silently drops it.

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 takes pitch, start_time, duration, velocity, mute, plus optional probability (0.0 to 1.0) and velocity_deviation.

  • replace: Replace existing notes in the clip (default True)

Inputs: notes (required), clip_index (required), track_index (required), replace.

add_shaped_automationA

Draw a repeating waveform onto any device parameter as clip automation.

This is NOT a free-running LFO. The curve is baked into the clip and repeats every loop, phase-locked to the bar. For a genuinely free-running LFO on an arbitrary parameter you still need a Max for Live LFO, whose Map button the API cannot set (ask the user to click it). Use this when a loop-locked, editable curve is acceptable, and use a long or coprime clip length if you want the repetition to be hard to notice.

Parameters:

  • track_index, clip_index: the clip to draw the automation into

  • parameter_name: the parameter to modulate

  • device_index: which device on the track owns that parameter

  • shape: sine, triangle, saw, square, or random

  • cycles: how many full waveform cycles across the clip (can be fractional)

  • min_value, max_value: the range the parameter sweeps between

  • points: resolution of the drawn curve (more = smoother)

Inputs: clip_index (required), track_index (required), device_index (required), parameter_name (required), +5 more.

add_warp_markerB

Add a warp marker to an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • beat_time: The beat time position for the marker

  • sample_time: Optional sample time (calculated automatically if not provided)

Inputs: beat_time (required), clip_index (required), track_index (required), sample_time.

apply_grooveB

Apply a groove to a clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • groove_index: The index of the groove from the groove pool

Inputs: clip_index (required), track_index (required), groove_index (required).

browse_pathB

Navigate browser by path list to get items at that location.

Parameters:

  • path: List of path components, e.g. ["Audio Effects", "EQ Eight"] or ["Sounds", "Bass"]

Inputs: path (required).

capture_midiA

Capture MIDI that was played recently (like Ableton's Capture feature).

Inputs: no named parameters.

clear_clip_automationC

Clear automation for a clip parameter.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • parameter_name: Name of the parameter to clear automation for

Inputs: clip_index (required), track_index (required), parameter_name (required).

commit_grooveC

Commit groove quantization to clip notes (make it permanent).

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

create_arrangement_midi_clipA

Create a MIDI clip in the Arrangement view, optionally filled with notes.

Session clips and Arrangement clips use different Live APIs. This is the Arrangement path (Live 11+). Notes are optional and may carry probability, same shape as add_notes_with_probability.

Parameters:

  • track_index: The index of the MIDI track

  • start_time: Where the clip starts in the arrangement, in beats

  • length: Clip length in beats

  • notes: Optional list of note dicts (pitch, start_time, duration, velocity, mute, optional probability). Note start_time is relative to the clip.

Inputs: length (required), start_time (required), track_index (required), notes.

create_audio_trackA

Create a new audio track in the Ableton session.

Parameters:

  • index: The index to insert the track at (-1 = end of list)

Inputs: index.

create_clipA

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)

Inputs: clip_index (required), track_index (required), length.

create_group_trackA

Create a group track containing the specified tracks.

Parameters:

  • track_indices: List of track indices to group

  • name: Name for the group track

Inputs: track_indices (required), name.

create_locatorA

Create a new locator/cue point.

Parameters:

  • time: Position in beats for the locator

  • name: Name for the locator

Inputs: time (required), name.

create_midi_trackB

Create a new MIDI track in the Ableton session.

Parameters:

  • index: The index to insert the track at (-1 = end of list)

Inputs: index.

create_return_trackA

Create a new return track (for shared send effects like reverb).

Inputs: no named parameters.

create_sceneB

Create a new scene.

Parameters:

  • index: The index to insert the scene at (-1 = end of list)

Inputs: index.

delete_clipA

Delete a clip from a clip slot.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

Inputs: clip_index (required), track_index (required).

delete_deviceA

Delete a device from a track.

Parameters:

  • track_index: The index of the track containing the device

  • device_index: The index of the device to delete

Inputs: track_index (required), device_index (required).

delete_locatorC

Delete a locator.

Parameters:

  • locator_index: Index of the locator to delete

Inputs: locator_index (required).

delete_return_trackA

Delete a return track.

Parameters:

  • index: The index of the return track to delete

Inputs: index (required).

delete_sceneC

Delete a scene.

Parameters:

  • scene_index: The index of the scene to delete

Inputs: scene_index (required).

delete_trackC

Delete a track.

Parameters:

  • track_index: The index of the track to delete

Inputs: track_index (required).

delete_warp_markerC

Delete a warp marker from an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • beat_time: The beat time position of the marker to delete

Inputs: beat_time (required), clip_index (required), track_index (required).

duplicate_clipA

Duplicate a clip to the next empty slot.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

Inputs: clip_index (required), track_index (required).

duplicate_sceneC

Duplicate a scene.

Parameters:

  • scene_index: The index of the scene to duplicate

Inputs: scene_index (required).

duplicate_trackB

Duplicate a track with all its clips and devices.

Parameters:

  • track_index: The index of the track to duplicate

Inputs: track_index (required).

fire_clipA

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

Inputs: clip_index (required), track_index (required).

fire_sceneA

Fire (trigger) a scene to play all clips in that row.

Parameters:

  • scene_index: The index of the scene to fire

Inputs: scene_index (required).

flatten_trackA

Flatten a frozen track (convert freeze to permanent audio). The track must be frozen first.

Parameters:

  • track_index: The index of the track to flatten

Inputs: track_index (required).

focus_viewB

Focus a specific view in Ableton.

Parameters:

  • view_name: The name of the view (Session, Arranger, Detail, etc.)

Inputs: view_name (required).

fold_trackA

Fold (collapse) a group track.

Parameters:

  • track_index: The index of the group track

Inputs: track_index (required).

freeze_trackB

Freeze a track (render all devices to audio for CPU optimization).

Parameters:

  • track_index: The index of the track to freeze

Inputs: track_index (required).

generate_basslineA

Generate a bassline pattern and add it to a clip.

Parameters:

  • track_index: The index of the track (should be a bass track)

  • clip_index: The index of the clip slot

  • root: Root note MIDI number (36 = C1, common bass range)

  • scale_type: Scale to use (minor, major, dorian, pentatonic_minor, blues)

  • length: Pattern length in beats

Inputs: clip_index (required), track_index (required), root, length, +1 more.

generate_drum_patternA

Generate a drum pattern and add it to a clip.

Parameters:

  • track_index: The index of the track (should be a drum track)

  • clip_index: The index of the clip slot

  • style: Pattern style (basic, house, hiphop, dnb, random)

  • length: Pattern length in beats

Inputs: clip_index (required), track_index (required), style, length.

get_all_scenesB

Get information about all scenes in the session.

Inputs: no named parameters.

get_arrangement_clip_notesA

Read the MIDI notes of a clip on a track's Arrangement timeline.

get_clip_notes addresses Session clip slots, so it cannot see notes that live on the timeline and reports "No clip in slot" instead. Use this for Arrangement clips, with the clip_index reported by get_arrangement_clips.

Returns probability and velocity_deviation per note where Live exposes them (has_probability tells you whether it could).

A looped clip stores one copy of its notes and repeats them, so a 16-beat loop stretched across 1147 beats returns 16 beats of notes. Compare loop_start/loop_end against start_time/end_time to see the repetition.

Parameters:

  • track_index: The index of the track

  • clip_index: Index of the clip on the timeline, from get_arrangement_clips

Inputs: clip_index (required), track_index (required).

get_arrangement_clipsA

Read the clips on a track's Arrangement timeline (name, position, length, MIDI/audio, muted).

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_arrangement_lengthA

Get the length and loop settings of the arrangement.

Inputs: no named parameters.

get_available_inputsC

Get available input routing options for a track.

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_available_outputsC

Get available output routing options for a track.

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_browser_items_at_pathA

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

Inputs: path (required).

get_browser_treeA

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

Inputs: category_type.

get_chain_device_parametersA

Get parameters of a device nested inside a rack chain, for example one drum pad's synth.

Plain get_device_parameters on a rack only returns the rack's own macros, which are usually unassigned. Use get_rack_chains first to find the chain index, then this to reach the device inside it.

Parameters:

  • track_index: The index of the track

  • device_index: The index of the rack on the track

  • chain_index: The index of the chain inside the rack

  • chain_device_index: The index of the device inside that chain

Inputs: chain_index (required), track_index (required), device_index (required), chain_device_index (required).

get_clip_automationC

Get automation data for a clip parameter.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • parameter_name: Name of the parameter to get automation for

Inputs: clip_index (required), track_index (required), parameter_name (required).

get_clip_colorA

Get the color of a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

get_clip_gainB

Get the gain of an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

get_clip_loopC

Get the loop settings of a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

get_clip_notesB

Get all MIDI notes from a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

Inputs: clip_index (required), track_index (required).

get_clip_pitchB

Get the pitch shift of an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

get_clip_warp_infoC

Get warp information for an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

get_cpu_loadA

Get the current CPU load of Ableton.

Inputs: no named parameters.

get_current_viewB

Get information about the current view state (selected track, scene, etc.).

Inputs: no named parameters.

get_device_by_nameC

Find a device by name and get its parameters.

Parameters:

  • track_index: The index of the track

  • device_name: The name of the device to find

Inputs: device_name (required), track_index (required).

get_device_parametersA

Get all parameters from a device on a track.

Parameters:

  • track_index: The index of the track containing the device

  • device_index: The index of the device on the track

Inputs: track_index (required), device_index (required).

get_groove_poolA

Get available grooves from the groove pool.

Inputs: no named parameters.

get_locatorsA

Get all locators/cue points in the arrangement.

Inputs: no named parameters.

get_master_device_parametersA

Get parameters of a device on the Master track (e.g. a mastering compressor).

The Master track holds effects like the rest, and the Live API reaches them fine; they just need this dedicated command.

Parameters:

  • device_index: The index of the device on the Master track

Inputs: device_index (required).

get_master_infoA

Get information about the master track including volume, pan, and devices.

Inputs: no named parameters.

get_metronome_stateA

Get the current metronome state.

Inputs: no named parameters.

get_playback_positionA

Get the current playback position and transport state.

Inputs: no named parameters.

get_rack_chainsC

Get chains from an instrument or effect rack.

Parameters:

  • track_index: The index of the track

  • device_index: The index of the rack device

Inputs: track_index (required), device_index (required).

get_return_device_parametersA

Get parameters of a device on a return track (e.g. a reverb on Return A).

Parameters:

  • return_index: The index of the return track (0 = A, 1 = B, ...)

  • device_index: The index of the device on that return track

Inputs: device_index (required), return_index (required).

get_return_track_infoC

Get detailed information about a return track.

Parameters:

  • return_index: The index of the return track

Inputs: return_index (required).

get_return_tracksA

Get information about all return (aux) tracks.

Inputs: no named parameters.

get_scale_notesA

Get the notes in a musical scale.

Parameters:

  • root: MIDI note number for the root (0-127, where 60 = middle C)

  • scale_type: Type of scale (major, minor, dorian, phrygian, lydian, mixolydian, locrian, harmonic_minor, melodic_minor, pentatonic_major, pentatonic_minor, blues, chromatic)

Inputs: root (required), scale_type.

get_scene_colorC

Get the color of a scene.

Parameters:

  • scene_index: The index of the scene

Inputs: scene_index (required).

get_send_levelA

Get the send level from a track to a return track.

Parameters:

  • track_index: The index of the source track

  • send_index: The index of the send (0=A, 1=B, etc.)

Inputs: send_index (required), track_index (required).

get_session_infoB

Get detailed information about the current Ableton session

Inputs: no named parameters.

get_session_pathA

Get the file path of the current session.

Inputs: no named parameters.

get_song_scale_namesA

List the scale names Live accepts, plus the current scale and root note.

Useful before set_song_scale, so you pass a name Live recognises rather than guessing.

Inputs: no named parameters.

get_track_colorC

Get the color of a track.

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_track_infoC

Get detailed information about a specific track in Ableton.

Parameters:

  • track_index: The index of the track to get information about

Inputs: track_index (required).

get_track_input_routingB

Get the input routing of a track.

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_track_monitoringB

Get the monitoring mode of a track.

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_track_output_routingC

Get the output routing of a track.

Parameters:

  • track_index: The index of the track

Inputs: track_index (required).

get_warp_markersA

Get all warp markers from an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

health_checkA

Check if Ableton Live is connected and responsive.

Inputs: no named parameters.

humanize_clip_timingA

Add random timing variation to notes in a clip for a more human feel.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • amount: Amount of timing variation in beats (0.05 = subtle, 0.1 = moderate, 0.2 = heavy)

Inputs: clip_index (required), track_index (required), amount.

humanize_clip_velocityA

Add random velocity variation to notes in a clip for a more human feel.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • amount: Amount of velocity variation (0.1 = +/-10%, 0.2 = +/-20%)

Inputs: clip_index (required), track_index (required), amount.

is_session_modifiedA

Check if the session has unsaved changes.

Inputs: no named parameters.

jump_to_timeA

Jump to a specific time in the arrangement.

Parameters:

  • time: Position in beats to jump to

Inputs: time (required).

load_drum_kitB

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

Inputs: kit_path (required), rack_uri (required), track_index (required).

load_instrument_or_effectC

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

Inputs: uri (required), track_index (required).

load_item_to_returnA

Load a browser item (effect) onto a return track by URI.

Parameters:

  • return_index: The index of the return track to load the item onto

  • uri: The URI of the browser item (obtained from browse_path or search_browser)

Inputs: uri (required), return_index (required).

load_item_to_trackA

Load a browser item (instrument or effect) onto a track by URI.

Parameters:

  • track_index: The index of the track to load the item onto

  • uri: The URI of the browser item (obtained from browse_path or search_browser)

Inputs: uri (required), track_index (required).

move_device_leftA

Move a device one position to the left in the device chain.

Parameters:

  • track_index: The index of the track containing the device

  • device_index: The index of the device to move

Inputs: track_index (required), device_index (required).

move_device_rightA

Move a device one position to the right in the device chain.

Parameters:

  • track_index: The index of the track containing the device

  • device_index: The index of the device to move

Inputs: track_index (required), device_index (required).

quantize_clipB

Quantize the notes in a clip to a grid.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • quantize_to: Grid in beats (0.25 = sixteenth note, 1.0 = quarter note)

  • amount: How strongly to pull toward the grid (0.0 to 1.0)

Inputs: clip_index (required), track_index (required), amount, quantize_to.

quantize_clip_notesA

Quantize notes in a clip to a grid.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • grid: Grid size in beats (0.25 = 16th notes, 0.5 = 8th notes, 1.0 = quarter notes)

Inputs: clip_index (required), track_index (required), grid.

redoA

Redo the last undone operation in Ableton.

Inputs: no named parameters.

remove_all_notesB

Remove all notes from a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

Inputs: clip_index (required), track_index (required).

remove_notesA

Remove notes from a clip within a specified range.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • from_time: Start time in beats

  • time_span: Duration in beats

  • from_pitch: Starting MIDI pitch (0-127)

  • pitch_span: Number of pitches to include

Inputs: clip_index (required), track_index (required), from_time, time_span, +2 more.

search_browserA

Search the browser for items matching a query.

Parameters:

  • query: Search term to find in item names

  • category: Category to search in (all, instruments, sounds, drums, audio_effects, midi_effects)

Inputs: query (required), category.

select_clipC

Select a clip slot.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot

Inputs: clip_index (required), track_index (required).

select_rack_chainA

Select a chain in a rack device.

Parameters:

  • track_index: The index of the track

  • device_index: The index of the rack device

  • chain_index: The index of the chain to select

Inputs: chain_index (required), track_index (required), device_index (required).

select_sceneC

Select a scene.

Parameters:

  • scene_index: The index of the scene to select

Inputs: scene_index (required).

select_trackC

Select a track.

Parameters:

  • track_index: The index of the track to select

Inputs: track_index (required).

set_arrangement_clip_notesA

Write notes into an existing Arrangement clip, editing it in place.

Prefer this over create_arrangement_midi_clip when the clip already exists. Creating a clip builds a new one, which discards the loop braces, the name, the colour and any clip envelopes. Editing keeps all of it, so a 16-beat loop stretched across 300 bars stays stretched instead of collapsing.

Notes keep probability and velocity_deviation, so randomness and humanization survive. Read with get_arrangement_clip_notes, change what you need, write the whole list back, and everything else is preserved.

Parameters:

  • track_index: The index of the track

  • clip_index: Index of the clip on the timeline, from get_arrangement_clips

  • notes: Note dicts (pitch, start_time, duration, velocity, mute, optional probability and velocity_deviation). start_time is relative to the clip.

  • replace: True clears the clip's existing notes first. False layers the new notes on top of what is already there.

Inputs: notes (required), clip_index (required), track_index (required), replace.

set_arrangement_loopA

Set the arrangement loop region.

Parameters:

  • start: Loop start position in beats

  • end: Loop end position in beats

  • enabled: Whether to enable looping

Inputs: end (required), start (required), enabled.

set_chain_device_parameterA

Set a parameter on a device nested inside a rack chain, for example a drum pad's decay.

The parameter name is resolved within that one device only, so it cannot grab a same-named parameter from elsewhere.

Parameters:

  • track_index: The index of the track

  • device_index: The index of the rack on the track

  • chain_index: The index of the chain inside the rack

  • chain_device_index: The index of the device inside that chain

  • parameter_name: Name of the parameter to set

  • value: The new value (clamped to the parameter's range)

Inputs: value (required), chain_index (required), track_index (required), device_index (required), +2 more.

set_clip_automationC

Set automation for a clip parameter.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • parameter_name: Name of the parameter to automate

  • envelope_data: List of points [{"time": 0.0, "value": 0.5}, ...]

Inputs: clip_index (required), track_index (required), envelope_data (required), parameter_name (required).

set_clip_colorB

Set the color 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

  • color: The color index (0-69 in Ableton's color palette)

Inputs: color (required), clip_index (required), track_index (required).

set_clip_end_markerB

Set a clip's end marker, in beats.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • position: End marker position in beats

Inputs: position (required), clip_index (required), track_index (required).

set_clip_fade_inA

Set an audio clip's fade-in region, in beats.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • start: Fade-in start position in beats

  • end: Fade-in end position in beats

Inputs: end (required), start (required), clip_index (required), track_index (required).

set_clip_fade_outA

Set an audio clip's fade-out region, in beats.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • start: Fade-out start position in beats

  • end: Fade-out end position in beats

Inputs: end (required), start (required), clip_index (required), track_index (required).

set_clip_follow_actionA

Set a clip's follow action, so it advances to another clip on its own.

This is how you get generative arrangements that progress while each track keeps looping independently.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • action_a, action_b: one of none, stop, again, previous, next, first, last, any, other, jump. The clip picks between A and B by chance.

  • chance: weighting between action_a and action_b (0.0 to 1.0)

  • time: how long before the action fires, in bars

  • enabled: turn the clip's follow-action switch on or off

Inputs: clip_index (required), track_index (required), time, chance, +3 more.

set_clip_gainB

Set the gain of an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • gain: Gain in dB (e.g., -6.0 for -6dB, 3.0 for +3dB)

Inputs: gain (required), clip_index (required), track_index (required).

set_clip_loopA

Set the loop settings 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

  • loop_start: The start point of the loop in beats

  • loop_end: The end point of the loop in beats

  • looping: Whether looping is enabled

Inputs: clip_index (required), track_index (required), looping, loop_end, +1 more.

set_clip_nameB

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

Inputs: name (required), clip_index (required), track_index (required).

set_clip_pitchA

Set the pitch shift of an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • pitch: Pitch shift in semitones (-48 to +48)

Inputs: pitch (required), clip_index (required), track_index (required).

set_clip_start_markerA

Set a clip's start marker, in beats.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • position: Start marker position in beats

Inputs: position (required), clip_index (required), track_index (required).

set_clip_warp_modeB

Set the warp mode of an audio clip.

Parameters:

  • track_index: The index of the track

  • clip_index: The index of the clip slot

  • warp_mode: Warp mode (beats, tones, texture, repitch, complex, complex_pro)

Inputs: warp_mode (required), clip_index (required), track_index (required).

set_device_parameterA

Set a device parameter value.

Parameters:

  • track_index: The index of the track containing the device

  • device_index: The index of the device on the track

  • parameter_index: The index of the parameter to set

  • value: The new value for the parameter (will be clamped to valid range)

Inputs: value (required), track_index (required), device_index (required), parameter_index (required).

set_master_device_parameterA

Set a parameter on a Master-track device (e.g. the Glue Compressor threshold).

Parameters:

  • device_index: The index of the device on the Master track

  • parameter_name: Name of the parameter to set

  • value: The new value (clamped to the parameter's range)

Inputs: value (required), device_index (required), parameter_name (required).

set_master_panA

Set the master track panning.

Parameters:

  • pan: Pan position from -1.0 (full left) to 1.0 (full right). 0.0 is center.

Inputs: pan (required).

set_master_volumeA

Set the master track volume.

Parameters:

  • volume: Volume level from 0.0 (silent) to 1.0 (unity gain). 0.85 is Ableton's default.

Inputs: volume (required).

set_metronomeA

Turn the metronome on or off.

Parameters:

  • enabled: True to enable, False to disable

Inputs: enabled (required).

set_overdubB

Set overdub mode.

Parameters:

  • enabled: True to enable overdub, False to disable

Inputs: enabled (required).

set_return_device_parameterA

Set a parameter on a return-track device (e.g. reverb decay on Return A).

Parameters:

  • return_index: The index of the return track (0 = A, 1 = B, ...)

  • device_index: The index of the device on that return track

  • parameter_name: Name of the parameter to set

  • value: The new value (clamped to the parameter's range)

Inputs: value (required), device_index (required), return_index (required), parameter_name (required).

set_return_panB

Set the panning of a return track.

Parameters:

  • return_index: The index of the return track

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

Inputs: pan (required), return_index (required).

set_return_volumeA

Set the volume of a return track.

Parameters:

  • return_index: The index of the return track

  • volume: The volume level (0.0 to 1.0)

Inputs: volume (required), return_index (required).

set_scene_colorA

Set the color of a scene.

Parameters:

  • scene_index: The index of the scene

  • color: The color index (0-69 in Ableton's color palette)

Inputs: color (required), scene_index (required).

set_scene_nameB

Set the name of a scene.

Parameters:

  • scene_index: The index of the scene to rename

  • name: The new name for the scene

Inputs: name (required), scene_index (required).

set_send_levelA

Set the send level from a track to a return track.

Parameters:

  • track_index: The index of the source track

  • send_index: The index of the send (corresponds to return track index)

  • level: The send level (0.0 to 1.0)

Inputs: level (required), send_index (required), track_index (required).

set_song_root_noteA

Set the song's root note. Pair with set_song_scale to set the key.

Parameters:

  • root_note: 0 to 11, where 0 is C, 1 is C#, ... 9 is A, 11 is B.

Inputs: root_note (required).

set_song_scaleA

Set the song scale. Pair with set_song_root_note to set the key.

Use get_song_scale_names first to see the accepted names.

Parameters:

  • scale_name: A scale name Live recognises, for example "Major", "Minor", "Dorian", "Lydian".

Inputs: scale_name (required).

set_tempoA

Set the tempo of the Ableton session.

Parameters:

  • tempo: The new tempo in BPM

Inputs: tempo (required).

set_track_armA

Set the arm (record enable) state of a track.

Parameters:

  • track_index: The index of the track

  • arm: True to arm for recording, False to disarm

Inputs: arm (required), track_index (required).

set_track_colorA

Set the color of a track.

Parameters:

  • track_index: The index of the track

  • color: The color index (0-69 in Ableton's color palette)

Inputs: color (required), track_index (required).

set_track_delayA

Set a track's delay compensation in milliseconds (nudges the track early or late).

Parameters:

  • track_index: The index of the track

  • delay_ms: Delay in milliseconds (can be negative to pull the track earlier)

Inputs: delay_ms (required), track_index (required).

set_track_input_routingA

Set the input routing of a track.

Parameters:

  • track_index: The index of the track

  • routing_type: The input routing type (use get_available_inputs to see options)

  • routing_channel: The input channel (optional)

Inputs: track_index (required), routing_type (required), routing_channel.

set_track_monitoringA

Set the monitoring mode of a track.

Parameters:

  • track_index: The index of the track

  • monitoring: Monitoring mode (in, auto, off)

Inputs: monitoring (required), track_index (required).

set_track_muteA

Set the mute state of a track.

Parameters:

  • track_index: The index of the track

  • mute: True to mute, False to unmute

Inputs: mute (required), track_index (required).

set_track_nameC

Set the name of a track.

Parameters:

  • track_index: The index of the track to rename

  • name: The new name for the track

Inputs: name (required), track_index (required).

set_track_output_routingA

Set the output routing of a track.

Parameters:

  • track_index: The index of the track

  • routing_type: The output routing type (use get_available_outputs to see options)

  • routing_channel: The output channel (optional)

Inputs: track_index (required), routing_type (required), routing_channel.

set_track_panA

Set the panning of a track.

Parameters:

  • track_index: The index of the track

  • pan: Pan position from -1.0 (full left) to 1.0 (full right). 0.0 is center.

Inputs: pan (required), track_index (required).

set_track_soloA

Set the solo state of a track.

Parameters:

  • track_index: The index of the track

  • solo: True to solo, False to unsolo

Inputs: solo (required), track_index (required).

set_track_volumeA

Set the volume of a track.

Parameters:

  • track_index: The index of the track

  • volume: Volume level from 0.0 (silent) to 1.0 (unity gain). 0.85 is Ableton's default.

Inputs: volume (required), track_index (required).

start_playbackA

Start playing the Ableton session.

Inputs: no named parameters.

start_recordingB

Start recording in Ableton.

Inputs: no named parameters.

stop_all_clipsA

Stop every playing clip in the session.

Inputs: no named parameters.

stop_clipB

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

Inputs: clip_index (required), track_index (required).

stop_playbackA

Stop playing the Ableton session.

Inputs: no named parameters.

stop_recordingB

Stop recording in Ableton.

Inputs: no named parameters.

stop_sceneA

Stop all clips in a scene.

Parameters:

  • scene_index: The index of the scene to stop

Inputs: scene_index (required).

tap_tempoA

Tap the tempo once (call repeatedly in time to set a tempo by feel).

Inputs: no named parameters.

toggle_arrangement_recordA

Toggle arrangement record mode.

Inputs: no named parameters.

toggle_deviceA

Toggle a device on or off.

Parameters:

  • track_index: The index of the track containing the device

  • device_index: The index of the device on the track

Inputs: track_index (required), device_index (required).

toggle_session_recordC

Toggle session record mode.

Inputs: no named parameters.

transpose_notesA

Transpose all notes in a clip.

Parameters:

  • track_index: The index of the track containing the clip

  • clip_index: The index of the clip slot containing the clip

  • semitones: Number of semitones to transpose (positive = up, negative = down)

Inputs: semitones (required), clip_index (required), track_index (required).

unarm_allA

Unarm all tracks in the session. Useful before recording to ensure only specific tracks will record.

Inputs: no named parameters.

undoB

Undo the last operation in Ableton.

Inputs: no named parameters.

unfold_trackB

Unfold (expand) a group track.

Parameters:

  • track_index: The index of the group track

Inputs: track_index (required).

ungroup_tracksA

Ungroup a group track, moving its children back out.

Parameters:

  • group_track_index: The index of the group track to ungroup

Inputs: group_track_index (required).

unmute_allA

Unmute every track.

Inputs: no named parameters.

unsolo_allA

Clear solo on every track.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 157 tools

    Disambiguation3/5

    Several tools have overlapping purposes, notably quantize_clip and quantize_clip_notes which appear to do the same thing with different parameter names, and add_notes_to_clip versus add_notes_with_probability where the latter is a superset. While many tools are clearly distinct, the duplication and the sheer number of similar getters/setters (e.g., get_track_color vs get_track_info) make misselection a real risk.

    Naming Consistency4/5

    The vast majority of tools follow a consistent verb_noun pattern, with get_/set_/create_/delete_/duplicate_ dominating. Minor exceptions like health_check and tap_tempo are rare and do not undermine the overall predictability. The naming is largely coherent.

    Tool Count2/5

    At 157 tools, this is far beyond the recommended range and would overwhelm most agents. Many tools are overly granular—such as separate getters for track color, monitoring, and routing when get_track_info already returns detailed data—suggesting significant consolidation is possible. The count is excessive even for a complex DAW.

    Completeness4/5

    The tool set covers the major lifecycle areas: tracks (create/delete/duplicate/group), clips (create/delete/notes/automation/warp), devices (get/set/move/delete), scenes, transport, browser, and session state. Minor gaps exist such as no direct move-track operation and no getter for clip start/end markers, but agents can generally work around these. Overall coverage is strong.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers