Ableton AI
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ableton AI Create a MIDI track with a soft pad and slow attack."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-scriptThen connect your AI client.
For Claude Code:
claude mcp add ableton -s user -- uvx ableton-aiFor 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 restStart it in its own terminal:
uv run python rest_api/rest_api_server.pyIt 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 mypyArchitecture
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 toolsadd_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
Scored across 157 tools
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.
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.
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.
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
Related MCP Connectors
Compose, mix, master and export in Logic Pro, REAPER or Ableton Live by talking to an AI engineer.
Browser DAW for AI assistants: build multitrack songs with MIDI, effects, stems and generation.
Score video, make music as an agent: 100+ AI instruments play your MIDI, audio, stems, Logic/Ableton
Read and edit DAW projects as an agent, save native Logic projects, convert projects between DAWs
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to control Ableton Live through natural language by querying tracks, analyzing sessions, and exporting stems via AbletonOSC integration.91MIT
- AlicenseNot gradedqualityDmaintenanceControl Ableton Live using natural language via AI assistants like Claude or Cursor.8MIT
- FlicenseCqualityCmaintenanceEnables full control of Ableton Live from AI assistants, including transport, tracks, clips, devices, and scene management through 143 tools.100-
- AlicenseNot gradedqualityDmaintenanceBridges AI assistants with Ableton Live, enabling real-time control, offline project analysis, version tracking, and rack/preset parsing for music production workflows.MIT