LiveMCP
LiveMCP exposes Ableton Live to MCP clients as a controller/inspection surface with 220 tools plus live://, max://, and docs:// resources.
Control transport, tempo, time signature, loop, metronome, record, undo/redo, cue points, and playhead position.
Manage tracks, scenes, clips, mixer state, routing, monitoring, arm/mute/solo, sends, and meters.
Load devices/instruments/effects, edit device parameters, rack chains, drum pads, and master/return devices.
Inspect current state through resources like live://status, live://session/current, live://view/current, live://selection/track, and track/device/scene templates.
Use Max for Live tools to inspect/edit bridge-enabled patchers (boxes, attributes, patchlines, presentation).
Search local Ableton/Cycling '74 docs and run install-status, validation-readiness, validation-target, and macOS Ableton lifecycle helpers.
Provides tools and resources for inspecting and manipulating Max for Live patchers within Ableton Live, including patcher session status, selected device metadata, and current patcher session summary.
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., "@LiveMCP Read live://status and check if playback is running"
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.
LiveMCP
LiveMCP turns Ableton Live into an MCP-accessible control surface.
It gives an MCP client two useful layers:
tools for doing things inside Live
live://...resources for reading stable state without stitching together a bunch of calls
The point is control and inspection. LiveMCP is built for tasks like selecting tracks, focusing views, firing clips, changing device parameters, checking transport state, handling startup dialogs, and keeping the remote script in sync with the package. It is not trying to be an AI songwriter.
What It Is
A Python MCP server that talks to Ableton over a local TCP bridge.
A bundled Ableton MIDI Remote Script that exposes the Live object model.
A controller-first interface for transport, views, tracks, clips, devices, mixer state, and session diagnostics.
Related MCP server: ableton-mcp
What It Is Not
Not a generative music framework.
Not a replacement for Ableton's UI.
Not a promise that every Live feature is scriptable; some parts of the Ableton API are still read-only or missing entirely.
At A Glance
220tools across session, clips, tracks, devices, mixer, arrangement, grooves, docs, and Max patcher controlcontroller-oriented MCP resources like
live://status,live://view/current,live://track/{track_index}, andmax://selected-devicelocal docs sync and offline search across official Ableton and Cycling '74 documentation
packaged install-status and Ableton restart helpers
install support for macOS, Windows, and WSL
macOS-only lifecycle automation for restart / quit / prompt handling
How People Actually Use It
"Read
live://selection/trackand tell me what's armed.""Show Session view, select track 3, set monitoring to Auto, and arm it."
"Read
live://statusbefore touching Ableton so we know whether the installed script is stale.""Focus the Browser, load Operator onto the selected track, and give me the current parameter values."
"Restart Live, dismiss the crash-recovery junk if it appears, and wait until the socket comes back."
Quick Start
1. Install the Remote Script
uvx livemcp --installThat finds Ableton, copies the bundled LiveMCP remote script into the right MIDI Remote Scripts folder, and leaves the package side ready to run.
Install works on macOS, Windows, and WSL. The TCP bridge works across WSL2 → Windows via localhost forwarding, so you can run the MCP server in WSL while Ableton runs on the Windows host. The app lifecycle helpers later in this README are macOS-only.
For local development on macOS, use a symlinked install instead:
uv run livemcp --install --symlink-install
# or: bash scripts/dev_install.sh2. Enable in Ableton
Open Ableton Live 12
Go to Preferences > Link, Tempo & MIDI
Under Control Surface, select LiveMCP
Status bar shows:
LiveMCP: Server started on port 9877
3. Add to Your AI Assistant
Claude Code (~/.mcp.json) or Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"LiveMCP": {
"command": "uvx",
"args": ["livemcp"]
}
}
}4. Try the Controller Surface
Once the server is running, the most useful starting points are:
read
live://statusrun
uv run livemcp --validation-readinessread
live://session/currentread
live://view/currentread
max://statusbefore using Max for Live patcher toolsread
docs://statuscall
get_session_infocall
show_view("Session")orfocus_view("Browser")call
search_docs("warp markers live.object")after syncing docs
Local Docs Sync
If you want a local searchable snapshot of the docs you actually build against, sync them once:
uv run livemcp --sync-docsThat crawls the configured official sources, stores raw HTML under ~/.cache/livemcp/docs/raw/,
and builds a local SQLite full-text index at ~/.cache/livemcp/docs/docs.sqlite3.
Current sources:
ableton-live-manual-12cycling74-max-docs
You can sync just one source:
uv run livemcp --sync-docs --docs-source ableton-live-manual-12Check local docs status:
uv run livemcp --docs-statusAfter syncing, use:
search_docs(query, source_id="all", limit=8)get_docs_chunk(chunk_id)get_docs_page(page_id)docs://statusdocs://chunk/{chunk_id}docs://page/{page_id}
Resources vs Tools
Use resources when you want a clean snapshot of current state:
live://statuslive://selection/tracklive://view/currentlive://track/0
Use tools when you want to change something:
start_playbackset_track_volumeselect_deviceshow_viewpress_current_dialog_button
That split matters. Tools are for actions. Resources are for inspection.
For plugin QA sessions, the quickest local readiness check is:
uv run livemcp --validation-readinessThat reports remote-script reachability, the currently selected track/device, and whether the Max bridge is attached for patcher inspection.
For screenshot QA, use the stricter target check:
uv run livemcp --confirm-validation-target --track-name "PEQ V2" --device-name "Parametric EQ V2"That confirms the intended comparison device is actually selected before you trust a screenshot.
For downstream generated-device QA (for example, validating m4l-builder output), keep the loop minimal: run --validation-readiness, confirm the exact target with --confirm-validation-target, then capture screenshots/measurements only after those checks pass.
Ableton Lifecycle Helpers (macOS)
Use the packaged helper when Live gets stuck on save, crash-recovery, or restore prompts:
uv run livemcp --restart-ableton
uv run livemcp --launch-ableton
uv run livemcp --quit-ableton--restart-ableton clears remote_script/__pycache__, removes Ableton crash-recovery markers
from ~/Library/Preferences/Ableton/Live */, quits Live, relaunches the detected Ableton app,
accepts common crash/restore dialogs when macOS Accessibility is available, and waits for the
LiveMCP socket on port 9877.
If the installed Ableton-side copy is missing or out of sync, restart also repairs it before relaunching Live.
Config file locations:
OS | Path |
macOS |
|
Windows |
|
Linux |
|
Capability Map
You do not need to memorize 220 commands to use LiveMCP well. The useful mental model is:
session tools for transport, selection, views, dialogs, and global state
track and mixer tools for routing, arm/solo/mute, levels, and return paths
device tools for loading instruments/effects and changing parameters
clip and arrangement tools for manipulating content that already exists in the set
docs tools for searching local snapshots of official Ableton and Max documentation
max tools for inspecting and editing supported Max for Live patchers through a local bridge
resources when you want a stable read surface for the current state
The tables below are the full reference.
Category | Count |
Session | 76 |
Clips | 40 |
Tracks | 32 |
Devices | 27 |
Mixer | 14 |
Arrangement | 9 |
Grooves | 5 |
Docs | 4 |
Max | 13 |
Total | 220 |
MCP Resources
These are meant for controller-style reads where a client wants stable Ableton state without chaining multiple tools.
Fixed Resources
Resource | Description |
| Combined local install state, remote reachability, and transport warnings |
| Global transport and timing state |
| Current playhead position and undo/redo state |
| Current UI view state, visible views, follow-song, and draw mode |
| Currently selected track |
| Currently selected scene |
| Currently selected device |
| Current Ableton dialog state |
| Local Max bridge reachability and Max-specific warnings |
| Selected Live device with Max for Live bridge metadata |
| Current attached Max patcher session summary |
| Local docs index status and synced source coverage |
Resource Templates
Resource | Description |
| Detailed track state |
| Detailed scene state |
| Scene clip-slot state across all tracks |
| Device parameters with display values |
| One indexed docs chunk from the local snapshot |
| One full docs page from the local snapshot |
Tool | Description |
| Tempo, time signature, track count, transport state |
| Current playhead position |
| SMPTE timecode (hours, minutes, seconds, frames) |
| Set BPM |
| Transport controls |
| Stop all playing clips |
| Toggle session recording |
| Arrangement recording on/off |
| Ableton Link and Start/Stop Sync |
| Tempo Follower on/off |
| Count-in duration and active count-in state |
| Session Record state and status |
| Numerator and denominator |
| Loop on/off, start, length |
| Undo/redo |
| Tap tempo |
| Metronome on/off |
| Quantization during recording |
| Capture recently played MIDI |
| Capture playing clips into a new scene |
| List all locators/cue points |
| Locator CRUD |
| Navigate cue points |
| Track selection |
| Scene selection |
| Scene tempo and time signature |
| Scene name, color, is_empty, clip count |
| All clips in a scene across all tracks |
| Per-scene tempo and time sig |
| Scene appearance |
| Scene management |
| Global groove and scale |
| Live version (major, minor, bugfix) |
| Remote-script transport protocol version and capability flags |
| Combined local install state, remote reachability, and transport warnings |
| Inspect and control Ableton dialog boxes |
| Average and peak Live CPU usage |
| Discover valid view names and visibility |
| Control Ableton UI views |
| Toggle browser hot-swap mode |
| Song time, length, CPU load |
| Current view, follow song, draw mode, visible views |
| Read and change selected device |
| Inspect the selected parameter |
| Inspect the selected rack chain |
| Toggle view options |
| Open clip in Detail View |
| Punch in/out |
| Re-enable overridden automation |
| Automation arm |
| Display text in Ableton's status bar |
Tool | Description |
| Clip CRUD |
| Launch and stop clips |
| Full clip info (type, length, loop, markers) |
| Batch set name, color, mute, gain, pitch, loop points |
| Individual properties |
| Loop on/off, start, end |
| Audio gain and pitch shift |
| Launch behavior |
| Warping control |
| RAM mode and velocity sensitivity |
| Current playhead within clip |
| Audio clip fade in/out lengths |
| Loop duplication and cropping |
| Quantize clip contents |
| Basic MIDI note editing |
| Notes with probability, velocity deviation, release velocity |
| Add notes with full MidiNoteSpecification params |
| Modify existing notes in place |
| Atomic note replacement (clear + add in one call) |
| Remove notes by pitch/time range |
| Automation envelopes |
Tool | Description |
| Track details |
| Create tracks |
| Track management |
| Appearance |
| Batch set name, volume, pan, mute, solo, arm, color |
| I/O routing |
| Monitor modes (auto, in, off) |
| Group track children |
| Fold/unfold group tracks |
| Return tracks |
| Check if track is frozen |
| Real-time output level |
| Playing, recording, triggered state |
| Clip slot color |
| Take-lane inspection and creation |
| Create clips inside take lanes |
Tool | Description |
| Browse Ableton's content library |
| Load any instrument or effect by URI, path, or name |
| Load drum rack presets |
| Load to master/return tracks |
| Raw parameter values (0.0–1.0) |
| Human-readable values ("2500 Hz", "-12 dB", "On") |
| Master track devices |
| Return track devices |
| List devices |
| Rack chain contents, activator, pan, volume, sends |
| Drum-chain note routing and choke settings |
| Drum rack pads |
| Remove devices |
| Reorder and enable/disable |
Tool | Description |
| All tracks: volume, pan, mute, solo, arm, sends |
| Level and panning |
| Mute, solo, arm |
| Send levels |
| Master track |
| Crossfader assignment (A/B/none) |
| Per-track output metering |
| Master output level (L/R) |
| Return track metering |
| All meters in one call |
Tool | Description |
| All clips on a track's timeline |
| Total arrangement length |
| Create MIDI clip at position |
| Place audio file on timeline |
| Copy session clip to arrangement |
| Remove arrangement clip |
| Overdub toggle |
| Return to arrangement playback |
Tool | Description |
| List all grooves in the pool |
| Timing, random, velocity amounts |
| Modify groove parameters |
| Assign groove to clip |
| Clear groove assignment |
Tool | Description |
| Describe the selected device and Max bridge attachment state |
| Open the selected Max device in the native Max editor |
| Summary of the current attached patcher session |
| List all patcher boxes in the current session |
| Inspect or change allowlisted object and box attributes |
| Create or remove a patcher box |
| Connect or disconnect patcher boxes |
| Update a box's presentation rect |
| Toggle or force presentation mode |
| Save the attached Max device in place |
V1 Max bridge note: the currently selected Max device must be bridge-enabled and
host the local bridge runtime itself. The packaged LiveMCP Bridge Probe.amxd
in the User Library Max Audio Effect/_Debug folder does this today.
Non-bridge-enabled third-party M4L devices remain explicit unsupported cases
rather than falling back to GUI scripting.
How It Works
┌─────────────────────────────────────────────────────────┐
│ MCP Client │
│ (Claude, Codex, etc.) │
└────────────────────────┬────────────────────────────────┘
│ MCP Protocol (stdio)
┌────────────────────────▼────────────────────────────────┐
│ Package-Side MCP Server │
│ src/livemcp/ (MCPServer) │
│ │
│ 220 tools + live://, max://, and docs:// resources │
│ structured controller state + action calls │
└────────────────────────┬────────────────────────────────┘
│ TCP Socket (localhost:9877)
┌────────────────────────▼────────────────────────────────┐
│ Ableton Remote Script │
│ remote_script/LiveMCP/ (Python 3.11) │
│ │
│ Live/browser commands: read + main-thread write split │
│ Max bridge commands: socket-thread proxying │
│ browser loading + Live API access │
└────────────────────────┬────────────────────────────────┘
│ TCP Socket (localhost:9881) for Max bridge
┌────────────────────────▼────────────────────────────────┐
│ Selected-Device Max Bridge Runtime │
│ node.script TCP server + js patcher runtime inside │
│ the bridge-enabled Max for Live device │
└────────────────────────┬────────────────────────────────┘
│ Live Object Model + Max patcher API
┌────────────────────────▼────────────────────────────────┐
│ Ableton Live 12 │
└─────────────────────────────────────────────────────────┘Three design choices matter most:
Thread safety — MCP 2 runs synchronous tools and resources on worker threads. A request lock serializes access to the shared Ableton socket. Inside Ableton, reads happen on the socket thread and writes are scheduled onto the main thread.
Max bridge dispatch — Max bridge commands stay on the socket thread because the actual patcher mutations happen inside the Max runtime; bouncing those calls through Ableton's main thread deadlocks editor/mutation requests.
Single-source registration — tool modules and handler registries fail fast on duplicate names instead of silently shadowing commands.
Controller-first state model — tools handle actions, and resources expose the current state a client usually wants to inspect before acting.
Design Notes
Native Max for Live support proposal: docs/native-max-for-live-support.md
Flagship plugin QA workflow (screenshot evidence you can trust): docs/plugin-qa-workflow.md
Developing LiveMCP
# Clone and set up
git clone https://github.com/alaarab/livemcp.git
cd livemcp
# Install remote script into Ableton
uv run livemcp --install
# or: bash scripts/install.sh
# See whether Ableton is using the current remote-script copy
uv run livemcp --install-status
# Run the MCP server locally
uv run livemcp
# Restart Ableton and wait for LiveMCP to come back
uv run livemcp --restart-ableton
# Build, test, and publish the current version
bash scripts/publish.sh --dry-run
# Verify tool count
uv run python -c "from livemcp.server import mcp; print(len(mcp._tool_manager._tools), 'tools')"For reproducible local verification from a fresh checkout:
# Install lint/test tooling declared in pyproject.toml
uv sync --group dev
# Unit tests
uv run python -m unittest discover -s tests -v
# Live bridge integration tests (requires Ableton + the LiveMCP remote script)
LIVEMCP_RUN_LIVE_TESTS=1 uv run pytest tests/live -v
# Lint
uv run ruff check src tests
uv run ty check src/livemcp/
# Tool registration sanity check (expected: 220)
uv run python -c "from livemcp.server import mcp; print(len(mcp._tool_manager._tools), 'tools')"For the local dev loop on macOS, the useful rhythm is:
uv run livemcp --install --symlink-installedit package or remote-script code
uv run livemcp --restart-abletontest against the running Live instance
bash scripts/publish.sh --dry-runbefore cutting a release
The live integration tier is opt-in because it controls the running Ableton UI.
It verifies dialog dispatch without pressing a real button, switches between
Session and Arrangement views and restores the original view, and selects a
device before restoring the original selection. See
tests/live/README.md for prerequisites and safety
details.
Project Structure
livemcp/
├── src/livemcp/ # MCP server (pip/uvx installable)
│ ├── server.py # MCPServer app, registers all tool modules
│ ├── connection.py # TCP client to remote script
│ ├── resources.py # live:// MCP resources for controller state
│ └── tools/ # 9 tool modules
│ ├── session.py # 76 session tools
│ ├── clips.py # 40 clip tools
│ ├── tracks.py # 32 track tools
│ ├── devices.py # 27 device tools
│ ├── mixer.py # 14 mixer tools
│ ├── arrangement.py # 9 arrangement tools
│ ├── grooves.py # 5 groove tools
│ ├── docs.py # 4 docs tools
│ └── max.py # 13 Max patcher tools
├── remote_script/LiveMCP/ # Ableton MIDI Remote Script
│ ├── __init__.py # create_instance() entry point
│ ├── server.py # TCP server + handler dispatch
│ ├── browser.py # 3-strategy device loading
│ └── handlers/ # 8 handler modules (Live + Max; docs tools are package-local)
└── scripts/
├── install.sh # Wrapper for `uv run livemcp --install`
├── dev_install.sh # Wrapper for `uv run livemcp --install --symlink-install`
├── publish.sh # Test/build/publish helper
├── uninstall.sh # Wrapper for `uv run livemcp --uninstall`
└── restart_ableton.sh # Wrapper for `uv run livemcp --restart-ableton`Known Limitations
Most of these are Ableton Live API limitations, not LiveMCP bugs:
Feature | Status | Notes |
Follow Actions | Not in API | Confirmed by Cycling '74 |
Stem Separation | Not in API | UI-only feature (Live 12.3+) |
Track Freeze/Flatten | Read-only | Can check |
Warp Markers | Read-only | Cannot add/move/delete warp markers |
Automation Envelopes | Limited | Can sample/insert values, cannot create from scratch |
Group Tracks | Cannot create | Can read group info, cannot create groups |
Groove Removal | API bug |
|
License
MIT
Available Tools
220 toolsadd_notes_extendedA
Add MIDI notes with extended properties to a clip.
Each note is a dict with: pitch (0-127), start_time (beat position), duration (in beats), velocity (0-127), and optionally probability (0.0-1.0), velocity_deviation (-127 to 127), release_velocity (0-127), mute (boolean).
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. notes: List of note dicts with pitch, start_time, duration, velocity, and optional probability, velocity_deviation, release_velocity, mute.
Inputs: notes (required), clip_index (required), track_index (required). Returns: result
add_notes_to_clipA
Add MIDI notes to an existing clip.
Each note is a dict with: pitch (0-127 MIDI note number), start_time (beat position), duration (in beats), velocity (0-127), and mute (boolean).
Prefer add_notes_extended when you need probability, velocity_deviation, or release_velocity per note.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. notes: List of note dicts, each with pitch, start_time, duration, velocity, mute.
Inputs: notes (required), clip_index (required), track_index (required). Returns: result
capture_and_insert_sceneA
Capture currently playing clips into a new scene.
Creates a new scene containing all currently playing session clips.
Inputs: no named parameters. Returns: result
capture_midiA
Capture recently played MIDI notes into a new clip.
Inputs: no named parameters. Returns: result
clear_all_clip_envelopesA
Clear all automation envelopes in a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
clear_clip_envelopeA
Clear the automation envelope for a specific device parameter in a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. device_index: Zero-based index of the device on the track. param_index: Zero-based index of the parameter on the device.
Inputs: clip_index (required), param_index (required), track_index (required), device_index (required). Returns: result
clear_clip_notesA
Remove all MIDI notes from a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
confirm_validation_targetA
Confirm that the intended comparison device is the current Ableton selection.
Provide at least one expected selector. Track and device names match case-insensitively after trimming whitespace.
Inputs: track_name, device_name, track_index, device_index. Returns: matches, message, warnings, track_matches, +9 more
continue_playingA
Continue playback from the current position without restart.
Inputs: no named parameters. Returns: result
create_arrangement_audio_clipA
Create an audio clip in the arrangement view from an audio file.
Args: track_index: Zero-based index of the track (must be an audio track). file_path: Absolute path to the audio file to load. position: Position in beats where the clip should be placed.
Inputs: position (required), file_path (required), track_index (required). Returns: result
create_arrangement_midi_clipA
Create a new empty MIDI clip in the arrangement view.
Args: track_index: Zero-based index of the track (must be a MIDI track). start_time: Start position of the clip in beats. length: Length of the clip in beats.
Inputs: length (required), start_time (required), track_index (required). Returns: result
create_audio_trackA
Create a new audio track in the session.
Args: index: Position to insert the track. Use -1 to append at the end.
Inputs: index. Returns: result
create_boxC
Create a new Max object box in the attached patcher.
Inputs: top (required), left (required), classname (required), args, +3 more. Returns: result
create_clipA
Create a new MIDI clip in a track's clip slot.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. length: Length of the clip in beats (default 4.0 = one bar at 4/4).
Inputs: clip_index (required), track_index (required), length. Returns: result
create_locatorA
Create a cue point (locator) at the current playhead position.
IMPORTANT: You must call set_song_time first to position the playhead at the desired location, then call create_locator. The locator is always created at the playhead position, not at an arbitrary time.
Inputs: no named parameters. Returns: result
create_midi_trackA
Create a new MIDI track in the session.
Args: index: Position to insert the track. Use -1 to append at the end.
Inputs: index. Returns: result
create_patchlineB
Create a patchline between two boxes.
Inputs: inlet (required), outlet (required), to_box_id (required), from_box_id (required), +2 more. Returns: result
create_return_trackA
Create a new return track in the session.
Inputs: no named parameters. Returns: result
create_sceneA
Create a new scene in the session.
Args: index: Position to insert the scene. Use -1 to append at the end.
Inputs: index. Returns: result
create_session_audio_clipB
Create a new audio clip in a clip slot from an audio file.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. file_path: Absolute path to the audio file to load.
Inputs: file_path (required), clip_index (required), track_index (required). Returns: result
create_take_laneA
Create a new take lane on a track.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
create_take_lane_audio_clipA
Create an audio clip inside a take lane from an audio file.
Args: track_index: Zero-based index of the track. take_lane_index: Zero-based index of the take lane. file_path: Absolute path to the audio file to load. start_time: Clip start position in beats.
Inputs: file_path (required), start_time (required), track_index (required), take_lane_index (required). Returns: result
create_take_lane_midi_clipA
Create a MIDI clip inside a take lane.
Args: track_index: Zero-based index of the track. take_lane_index: Zero-based index of the take lane. start_time: Clip start position in beats. length: Clip length in beats.
Inputs: length (required), start_time (required), track_index (required), take_lane_index (required). Returns: result
crop_clipB
Crop a clip to its loop boundaries.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
delete_arrangement_clipB
Delete a clip from the arrangement view.
Args: track_index: Zero-based index of the track. arrangement_clip_index: Index of the clip in the track's arrangement_clips list.
Inputs: track_index (required), arrangement_clip_index (required). Returns: result
delete_boxC
Delete a box from the attached patcher.
Inputs: box_id (required), bridge_session_id. Returns: result
delete_clipA
Delete a clip from a clip slot.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
delete_deviceA
Delete a device from a track's device chain.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device to delete.
Inputs: track_index (required), device_index (required). Returns: result
delete_locatorA
Delete a cue point (locator) by index.
Due to Ableton API limitations, deletion may require two calls:
First call positions the playhead at the cue point's time.
Second call actually deletes the cue point. Check the 'deleted' field in the response.
Args: index: Zero-based index of the cue point to delete.
Inputs: index (required). Returns: result
delete_master_deviceA
Delete a device from the master track's device chain.
Args: device_index: Zero-based index of the device to delete.
Inputs: device_index (required). Returns: result
delete_patchlineC
Delete a patchline between two boxes.
Inputs: inlet (required), outlet (required), to_box_id (required), from_box_id (required), +1 more. Returns: result
delete_return_deviceA
Delete a device from a return track's device chain.
Args: return_index: Zero-based index of the return track. device_index: Zero-based index of the device to delete.
Inputs: device_index (required), return_index (required). Returns: result
delete_return_trackA
Delete a return track from the session.
Args: return_index: Zero-based index of the return track to delete.
Inputs: return_index (required). Returns: result
delete_sceneA
Delete a scene from the session.
Args: scene_index: Zero-based index of the scene to delete.
Inputs: scene_index (required). Returns: result
delete_trackA
Delete a track from the session.
Args: track_index: Zero-based index of the track to delete.
Inputs: track_index (required). Returns: result
duplicate_clipA
Duplicate a clip to another clip slot.
Args: track_index: Zero-based index of the source track. clip_index: Zero-based index of the source clip slot. target_track_index: Zero-based index of the destination track. target_clip_index: Zero-based index of the destination clip slot.
Inputs: clip_index (required), track_index (required), target_clip_index (required), target_track_index (required). Returns: result
duplicate_clip_loopB
Duplicate the loop content of a clip, doubling its length.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
duplicate_sceneC
Duplicate a scene.
Args: scene_index: Zero-based index of the scene to duplicate.
Inputs: scene_index (required). Returns: result
duplicate_to_arrangementA
Duplicate a session clip to the arrangement view.
Args: track_index: Zero-based index of the track containing the session clip. clip_index: Zero-based index of the clip slot in session view. time: Position in beats where the duplicated clip should be placed in the arrangement.
Inputs: time (required), clip_index (required), track_index (required). Returns: result
duplicate_trackA
Duplicate a track.
Args: track_index: Zero-based index of the track to duplicate.
Inputs: track_index (required). Returns: result
enable_deviceA
Enable or disable a device on a track.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device. enabled: True to enable the device, False to disable it.
Inputs: enabled (required), track_index (required), device_index (required). Returns: result
fire_clipA
Start playing a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
fire_sceneA
Fire (launch) a scene, triggering all clips in that row.
Args: scene_index: Zero-based index of the scene.
Inputs: scene_index (required). Returns: result
focus_viewB
Show and focus an Ableton UI view.
Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.
Inputs: view_name (required). Returns: result
fold_trackA
Fold or unfold a group track.
Args: track_index: Zero-based index of the group track. fold: 1 to fold (collapse), 0 to unfold (expand).
Inputs: fold (required), track_index (required). Returns: result
get_all_track_metersA
Get output meter levels for all tracks and the master track.
Returns a dict with 'tracks' (list of per-track meter data) and 'master' meter data. Each entry includes output_meter_level, output_meter_left, and output_meter_right (0.0-1.0).
Inputs: no named parameters. Returns: result
get_all_tracks_infoA
Get summary information for all tracks at once.
Returns a list of all tracks with name, type, color, mute, solo, arm, is_foldable, is_grouped, device count, and clip count. Useful for getting a full session overview without making separate calls per track.
Inputs: no named parameters. Returns: result
get_application_cpu_usageA
Get Ableton application's average and peak CPU usage.
Inputs: no named parameters. Returns: result
get_application_dialogA
Get information about the current Ableton dialog box.
Returns open dialog count, current dialog message, and current dialog button count.
Inputs: no named parameters. Returns: open_dialog_count, current_dialog_message, current_dialog_button_count
get_application_infoA
Get Ableton Live application version info.
Returns major_version, minor_version, and bugfix_version.
Inputs: no named parameters. Returns: major_version, minor_version, bugfix_version
get_arrangement_clipsA
Get all clips in the arrangement view for a track.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
get_arrangement_lengthA
Get the total arrangement length in beats.
Returns the time position of the last event in the arrangement.
Inputs: no named parameters. Returns: result
get_arrangement_overdubA
Get the current arrangement overdub state.
Returns whether arrangement overdub is enabled (recording merges with existing clips).
Inputs: no named parameters. Returns: result
get_available_main_viewsA
Get the canonical Ableton view names accepted by view control tools.
Inputs: no named parameters. Returns: view_names
get_box_attrsC
Get object attrs and box attrs for a patcher box.
Inputs: box_id (required), bridge_session_id. Returns: box_id, box_attrs, object_attrs, bridge_session_id
get_browser_items_at_pathA
Get browser items at a specific path in Ableton's browser.
Use slash-separated paths like 'instruments/Operator' or 'drums/Kit-Core 909'.
Args: path: Slash-separated path into the browser hierarchy.
Inputs: path (required). Returns: result
get_browser_treeB
Get a hierarchical tree of categories from Ableton's browser.
Args: category_type: Filter by type — 'all', 'instruments', 'sounds', 'drums', 'audio_effects', or 'midi_effects'.
Inputs: category_type. Returns: result
get_clip_envelopeA
Sample the automation envelope for a device parameter in a Session clip.
The Ableton API does not expose individual breakpoints, so this samples the envelope value at evenly-spaced time positions across the clip. Returns envelope_exists=False if no envelope is set for the parameter. Only works for Session clips (not Arrangement clips).
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. device_index: Zero-based index of the device on the track. param_index: Zero-based index of the parameter on the device. num_steps: Number of sample points across the clip (2-128, default 16).
Inputs: clip_index (required), param_index (required), track_index (required), device_index (required), +1 more. Returns: result
get_clip_fadesA
Get the fade in and fade out lengths of an audio clip.
Returns fade_in_length and fade_out_length in beats. Only available for audio clips.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
get_clip_playing_positionA
Get the current playback position and state of a clip.
Returns playing_position (beat position within the clip), is_playing, and is_triggered (clip is queued to play).
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
get_clip_propertiesA
Get comprehensive properties of a clip.
Returns name, color, color_index, is_audio_clip, is_midi_clip, length, start_marker, end_marker, looping, loop_start, loop_end, launch_mode, launch_quantization, velocity_amount, muted, and has_groove (if available). For audio clips also returns file_path, ram_mode, gain, and gain_display_string.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
get_clip_slot_statusA
Get detailed status of a specific clip slot.
Returns playing, recording, and trigger state, color info, and clip details (name, length, color) if a clip is present.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
get_count_in_stateA
Get metronome count-in settings and current counting-in state.
Inputs: no named parameters. Returns: result
get_cue_pointsA
Get all cue points (locators) in the song.
Returns a list of cue points with index, name, and time.
Inputs: no named parameters. Returns: result
get_current_patcherB
Return summary metadata for the currently attached patcher.
Inputs: bridge_session_id. Returns: name, dirty, locked, filepath, +7 more
get_device_display_valuesA
Get all parameters of a device with both raw value and human-readable display value.
Similar to get_device_parameters but also includes is_enabled and the formatted display_value string (e.g. "100 Hz", "-6.0 dB") alongside the raw numeric value.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device in the track's device chain.
Inputs: track_index (required), device_index (required). Returns: result
get_device_parametersA
Get all parameters of a device on a track.
Returns the device name and a list of parameters with name, value, min, and max.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device in the track's device chain.
Inputs: track_index (required), device_index (required). Returns: result
get_docs_chunkB
Read a specific synced docs chunk by id.
Inputs: chunk_id (required). Returns: result
get_docs_pageB
Read a full synced docs page by id.
Inputs: page_id (required). Returns: result
get_docs_statusA
Get local docs index status and configured sources.
Inputs: no named parameters. Returns: db_path, docs_root, total_pages, total_chunks, +1 more
get_drum_chainsA
Get drum-chain-specific properties from a Drum Rack.
Returns each chain's name, mixer values, and drum-specific note/choke settings.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the drum rack device.
Inputs: track_index (required), device_index (required). Returns: result
get_drum_padsA
Get all visible drum pads from a drum rack device.
Returns pad index, name, MIDI note number, mute, and solo state for each pad.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the drum rack device.
Inputs: track_index (required), device_index (required). Returns: result
get_groove_poolA
Get all grooves in the groove pool.
Returns a list of all grooves with their index, name, base subdivision, quantization amount, timing amount, random amount, and velocity amount.
Inputs: no named parameters. Returns: result
get_groove_propertiesB
Get detailed properties of a specific groove.
Args: groove_index: Zero-based index of the groove in the groove pool.
Inputs: groove_index (required). Returns: result
get_group_infoA
Get group and fold information for a track.
Returns whether the track is foldable, whether it belongs to a group, its current fold state, and the group track name if grouped.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
get_link_stateA
Get Ableton Link and Tempo Follower state.
Inputs: no named parameters. Returns: result
get_livemcp_infoA
Get LiveMCP remote-script transport capability information.
Inputs: no named parameters. Returns: transport, max_bridge, namespaces, protocol_version, +2 more
get_livemcp_statusA
Get local install state and remote-script capability status.
Returns package version, client transport version, local install status, remote-script capability info when reachable, and actionable warnings.
Inputs: no named parameters. Returns: warnings, max_bridge, remote_info, remote_error, +5 more
get_master_device_parametersA
Get all parameters of a device on the master track.
Args: device_index: Zero-based index of the device in the master track's device chain.
Inputs: device_index (required). Returns: result
get_master_mixer_stateA
Get the mixer state of the master track.
Returns volume, pan, crossfader value, and a list of devices on the master track.
Inputs: no named parameters. Returns: result
get_master_output_meterA
Get the current output meter levels for the master track.
Returns output_meter_level (peak), output_meter_left, and output_meter_right. Values are in the range 0.0 to 1.0.
Inputs: no named parameters. Returns: result
get_master_track_devicesA
Get a list of all devices on the master track.
Returns device index, name, class_name, type, and is_active for each device.
Inputs: no named parameters. Returns: result
get_mixer_stateA
Get the mixer state of all tracks.
Returns volume, pan, mute, solo, and arm state for every track in the session.
Inputs: no named parameters. Returns: result
get_notes_extendedA
Read all MIDI notes from a clip with extended properties.
Returns notes with pitch, start_time, duration, velocity, mute, probability, velocity_deviation, and release_velocity.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
get_notes_from_clipA
Read all MIDI notes from a clip.
Returns a list of notes with pitch, start_time, duration, velocity, and mute.
Prefer get_notes_extended when you need probability, velocity_deviation, or release_velocity per note.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
get_punch_stateA
Get the punch in/out state.
Returns whether punch_in and punch_out are enabled.
Inputs: no named parameters. Returns: result
get_rack_chainsA
Get all chains in an instrument or effect rack device.
The device must support chains (i.e. be a rack). Returns chain name, mute, solo, chain activator, pan, volume, and sends.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the rack device.
Inputs: track_index (required), device_index (required). Returns: result
get_record_modeA
Get whether arrangement recording is armed.
Returns record_mode (True if armed, False otherwise).
Inputs: no named parameters. Returns: result
get_return_device_parametersA
Get all parameters of a device on a return track.
Args: return_index: Zero-based index of the return track. device_index: Zero-based index of the device in the return track's device chain.
Inputs: device_index (required), return_index (required). Returns: result
get_return_track_devicesA
Get a list of all devices on a return track.
Args: return_index: Zero-based index of the return track.
Inputs: return_index (required). Returns: result
get_return_track_output_meterA
Get the current output meter levels for a return track.
Args: return_index: Zero-based index of the return track.
Returns return_index, name, output_meter_level, output_meter_left, and output_meter_right. Values are in the range 0.0 to 1.0.
Inputs: return_index (required). Returns: result
get_return_tracksA
Get information about all return tracks in the session.
Returns a list of return tracks with name, mute, solo, volume, and pan.
Inputs: no named parameters. Returns: result
get_return_track_sendsA
Get the send values for a return track.
Returns the list of sends on a return track with their names and values.
Args: return_index: Zero-based index of the return track.
Inputs: return_index (required). Returns: result
get_scene_clipsA
Get all clips in a scene across all tracks.
Returns clip status for every track at the given scene index, including track name, whether a clip is present, clip name and color, and playing/recording/triggered state.
Args: scene_index: Zero-based index of the scene.
Inputs: scene_index (required). Returns: result
get_scene_infoA
Get detailed information about a specific scene.
Returns the scene name, color, tempo (if tempo_enabled), time signature (if available), is_empty flag (if available), and clip_count across all tracks.
Args: scene_index: Zero-based index of the scene.
Inputs: scene_index (required). Returns: name, color, index, tempo, +4 more
get_scene_propertiesA
Get properties of a specific scene.
Returns the scene name, tempo (-1.0 if not set), color, color_index, and (Live 12+) tempo_enabled, time_signature_numerator/denominator/enabled.
Args: scene_index: Zero-based index of the scene.
Inputs: scene_index (required). Returns: result
get_selected_chainA
Get the currently selected rack chain in Ableton's UI.
Inputs: no named parameters. Returns: selected_chain
get_selected_deviceA
Get the currently selected device on the selected track.
Inputs: no named parameters. Returns: track, selected_device
get_selected_max_deviceA
Return the selected Live device when it is a Max for Live device.
Returns selection metadata, whether the selected device is supported, the active bridge session id when attached, and Max bridge capability state.
Inputs: no named parameters. Returns: track, supported, max_bridge, bridge_attached, +4 more
get_selected_parameterA
Get the currently selected Ableton device parameter.
Inputs: no named parameters. Returns: selected_parameter
get_selected_sceneA
Get information about the currently selected scene.
Returns the index, name, and color of the selected scene.
Inputs: no named parameters. Returns: name, color, index
get_selected_trackA
Get information about the currently selected track.
Returns the index, name, type, mute/solo/arm state, and color of the selected track.
Inputs: no named parameters. Returns: arm, mute, name, solo, +3 more
get_session_automation_recordA
Get whether session automation recording is enabled.
Returns session_automation_record (True if enabled).
Inputs: no named parameters. Returns: result
get_session_infoA
Get the current Ableton Live session state.
Returns tempo, time signature, track count, return track count, master track info, playback state, and loop settings.
Inputs: no named parameters. Returns: loop, tempo, is_playing, loop_start, +7 more
get_session_metadataA
Get session metadata: modified state, current song time, song length, and CPU load.
Returns is_modified, current_song_time (beats), song_length (beats), and current_cpu_load (if available).
Inputs: no named parameters. Returns: is_modified, song_length, current_cpu_load, current_song_time
get_session_record_statusB
Get Session Record state and current record status.
Inputs: no named parameters. Returns: result
get_song_smpte_timeA
Get the current song time in SMPTE (timecode) format.
Returns hours, minutes, seconds, and frames.
Inputs: no named parameters. Returns: hours, frames, minutes, seconds
get_song_timeA
Get the current song time position and undo/redo availability.
Returns current_song_time (in beats), can_undo, and can_redo.
Inputs: no named parameters. Returns: can_redo, can_undo, current_song_time
get_take_lanesA
Get all take lanes for a track.
Returns take lane names and arrangement clips for each lane.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
get_track_freeze_statusA
Get the freeze status of a track.
Args: track_index: Zero-based index of the track.
Returns whether the track is frozen and whether it can be frozen. Note: Freezing/flattening cannot be triggered via the API (read-only status).
Inputs: track_index (required). Returns: result
get_track_infoA
Get detailed information about a specific track.
Returns the track name, type, mute/solo/arm state, volume, pan, list of clip slots with clip info, and list of devices.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
get_track_output_meterA
Get the output meter levels for a track.
Returns the current output meter level, left channel, and right channel values.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
get_track_routingA
Get the input and output routing configuration for a track.
Returns input/output routing type and channel display names, plus lists of all available input and output routing types.
Args: track_index: Zero-based index of the track.
Inputs: track_index (required). Returns: result
get_validation_readinessA
Summarize whether Ableton is ready for flagship plugin validation.
Returns remote reachability, selected track/device state, Max bridge availability, and suggested next steps for Live-side or Max-side QA.
Inputs: no named parameters. Returns: warnings, remote_error, selected_track, selected_device, +7 more
get_view_stateA
Get the current view state in Ableton Live.
Returns the selected track, detail clip (if any), draw mode, and follow song state.
Inputs: no named parameters. Returns: draw_mode, browse_mode, detail_clip, follow_song, +2 more
hide_viewA
Hide an Ableton UI view.
Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.
Inputs: view_name (required). Returns: result
insert_clip_envelope_stepA
Insert an automation breakpoint into a clip's parameter envelope.
Writes a single automation point at the given time with the given value. Creates the envelope if it does not exist yet. Only works for Session clips. Note: Arrangement clips will return an error.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. device_index: Zero-based index of the device on the track. param_index: Zero-based index of the parameter on the device. time: Time position in beats to insert the automation point. value: Automation value to set at the given time. curve: Curve shape (0.0 = linear, default 0.0).
Inputs: time (required), value (required), clip_index (required), param_index (required), +3 more. Returns: result
is_view_visibleA
Get whether an Ableton view is currently visible.
Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.
Inputs: view_name (required). Returns: visible, view_name
jump_to_cueA
Jump to a specific cue point by index.
Args: index: Zero-based index of the cue point to jump to.
Inputs: index (required). Returns: result
jump_to_next_cueA
Jump to the next cue point (locator).
Inputs: no named parameters. Returns: result
jump_to_prev_cueA
Jump to the previous cue point (locator).
Inputs: no named parameters. Returns: result
list_patcher_boxesA
List boxes in the attached patcher.
When named_only=True, request only boxes with a stable Max varname.
The Ableton-side bridge may also automatically fall back to this smaller
response when full enumeration times out on larger patchers.
Inputs: named_only, bridge_session_id. Returns: boxes, complete, fallback_reason, total_box_count, +2 more
load_device_on_masterA
Load a device onto the master track using its browser URI.
Use get_browser_tree or get_browser_items_at_path to discover available URIs.
Args: uri: The browser URI of the instrument or effect to load.
Inputs: uri (required). Returns: result
load_device_on_returnA
Load a device onto a return track using its browser URI.
Use get_browser_tree or get_browser_items_at_path to discover available URIs.
Args: return_index: Zero-based index of the return track. uri: The browser URI of the instrument or effect to load.
Inputs: uri (required), return_index (required). Returns: result
load_drum_kitB
Load a drum rack and then load a specific drum kit into it.
Args: track_index: Zero-based index of the target track. rack_uri: URI of the drum rack to load. 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). Returns: result
load_instrument_or_effectA
Load an instrument or effect onto a track using its browser URI.
Use get_browser_tree or get_browser_items_at_path to discover available URIs.
Args: track_index: Zero-based index of the target track. uri: The browser URI of the instrument or effect to load.
Inputs: uri (required), track_index (required). Returns: result
modify_notesA
Modify properties of existing MIDI notes in a clip.
Each modification dict must include pitch and start_time to identify the note, plus any properties to change: velocity, probability, velocity_deviation, release_velocity, mute.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. modifications: List of modification dicts, each with pitch, start_time, and properties to modify.
Inputs: clip_index (required), track_index (required), modifications (required). Returns: result
move_deviceA
Move a device to a new position in a track's device chain.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device to move. new_index: Zero-based target position in the device chain.
Inputs: new_index (required), track_index (required), device_index (required). Returns: result
open_selected_device_in_maxB
Open the selected Max device in the native Max editor.
Inputs: bridge_session_id. Returns: result
press_current_dialog_buttonA
Press a button in the current Ableton dialog box.
Args: index: Zero-based button index in the current dialog.
Inputs: index (required). Returns: result
quantize_clipA
Quantize notes in a clip to a grid.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. grid: RecordingQuantization enum value (1=1/4, 2=1/8, 3=1/8T, 4=1/8+T, 5=1/16, 6=1/16T, 7=1/16+T, 8=1/32). amount: Quantize strength from 0.0 to 1.0 (default 1.0 = full quantize).
Inputs: grid (required), clip_index (required), track_index (required), amount. Returns: result
redoA
Redo the last undone action in Ableton Live.
Inputs: no named parameters. Returns: result
re_enable_automationA
Re-enable automation that was overridden by manual parameter changes.
When you manually adjust an automated parameter, the automation is overridden. This re-enables all overridden automation.
Inputs: no named parameters. Returns: result
remove_clip_grooveA
Remove the groove assignment from a clip.
Note: This tool has a known API limitation — Ableton's API does not support removing groove assignments from clips. Consider setting groove properties to 0 instead (use set_groove_property to set quantization_amount, timing_amount, random_amount, and velocity_amount all to 0.0).
Args: track_index: Zero-based index of the track containing the clip. clip_index: Zero-based index of the clip slot containing the clip.
Inputs: clip_index (required), track_index (required). Returns: result
remove_notes_extendedA
Remove MIDI notes from a clip within an explicit pitch and time range.
All four range parameters are required. Use from_pitch=0, pitch_span=128 to span all pitches; use from_time=0 and time_span=999999 to span the full clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. from_pitch: Starting MIDI pitch (0-127). pitch_span: Number of pitches to cover (1-128). from_time: Start time in beats. time_span: Duration in beats to remove notes within.
Inputs: from_time (required), time_span (required), clip_index (required), from_pitch (required), +2 more. Returns: result
remove_notes_from_clipA
Remove MIDI notes from a clip within a pitch and time range.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. from_pitch: Starting pitch (0-127, default 0). pitch_span: Number of pitches to span (default 128 = all). from_time: Start time in beats (default 0.0). time_span: Time span in beats. If None, uses clip length.
Inputs: clip_index (required), track_index (required), from_time, time_span, +2 more. Returns: result
replace_all_notesA
Atomically replace all MIDI notes in a clip.
Removes every existing note then adds the provided notes in one operation. Each note is a dict with pitch, start_time, duration, and optionally velocity, mute, probability, velocity_deviation, release_velocity.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. notes: List of note dicts with pitch, start_time, duration, velocity, and optional probability, velocity_deviation, release_velocity, mute.
Inputs: notes (required), clip_index (required), track_index (required). Returns: result
save_max_deviceC
Save the selected Max device to its existing file path.
Inputs: bridge_session_id. Returns: result
search_docsB
Search locally synced Ableton and Max documentation.
Args: query: Search terms to match in the local docs index. source_id: Limit search to a specific synced source or use 'all'. limit: Maximum number of results to return.
Inputs: query (required), limit, source_id. Returns: result
select_clip_in_detailA
Select a clip and show it in the Detail View.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
select_deviceA
Select a device on a track in Ableton's UI.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device in the track's device chain.
Inputs: track_index (required), device_index (required). Returns: result
set_ableton_link_enabledA
Enable or disable Ableton Link.
Args: enabled: True to enable Link, False to disable it.
Inputs: enabled (required). Returns: result
set_ableton_link_start_stop_sync_enabledA
Enable or disable Ableton Link Start/Stop Sync.
Args: enabled: True to enable Start/Stop Sync, False to disable it.
Inputs: enabled (required). Returns: result
set_arrangement_overdubA
Set the arrangement overdub state.
When enabled, recording in arrangement view merges new notes with existing clip content instead of replacing it.
Args: enabled: True to enable overdub, False to disable.
Inputs: enabled (required). Returns: result
set_box_attrsC
Set allowlisted attrs for a patcher box.
Inputs: box_id (required), box_attrs, object_attrs, bridge_session_id. Returns: result
set_chain_mixer_valueB
Set a rack chain mixer parameter.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the rack device. chain_index: Zero-based index of the chain. parameter_name: One of 'chain_activator', 'pan', 'volume', or 'send'. value: New value for the target parameter. send_index: Zero-based send index when parameter_name is 'send'.
Inputs: value (required), chain_index (required), track_index (required), device_index (required), +2 more. Returns: result
set_clip_colorB
Set the color of a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. color_index: Ableton color index to set.
Inputs: clip_index (required), color_index (required), track_index (required). Returns: result
set_clip_fadesA
Set the fade in and/or fade out lengths of an audio clip.
Only provided values are changed. Returns the final fade_in_length and fade_out_length. Only available for audio clips.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. fade_in_length: Fade in length in beats. fade_out_length: Fade out length in beats.
Inputs: clip_index (required), track_index (required), fade_in_length, fade_out_length. Returns: result
set_clip_gainA
Set the gain of an audio clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. gain: Gain value to set.
Inputs: gain (required), clip_index (required), track_index (required). Returns: result
set_clip_grooveA
Assign a groove from the groove pool to a clip.
Args: track_index: Zero-based index of the track containing the clip. clip_index: Zero-based index of the clip slot containing the clip. groove_index: Zero-based index of the groove in the groove pool.
Inputs: clip_index (required), track_index (required), groove_index (required). Returns: result
set_clip_launch_modeA
Set the launch mode of a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. mode: Launch mode (0=Trigger, 1=Gate, 2=Toggle, 3=Repeat).
Inputs: mode (required), clip_index (required), track_index (required). Returns: result
set_clip_loopA
Set clip loop and marker properties.
All loop parameters are optional; only provided values are changed.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. looping: Enable or disable looping. loop_start: Loop start position in beats. loop_end: Loop end position in beats. start_marker: Start marker position in beats. end_marker: End marker position in beats.
Inputs: clip_index (required), track_index (required), looping, loop_end, +3 more. Returns: result
set_clip_mutedB
Set whether a clip is muted (deactivated).
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. muted: True to mute, False to unmute.
Inputs: muted (required), clip_index (required), track_index (required). Returns: result
set_clip_nameA
Set the name of a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. name: New name for the clip.
Inputs: name (required), clip_index (required), track_index (required). Returns: result
set_clip_pitchA
Set the pitch transposition of an audio clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. coarse: Coarse pitch in semitones (-48 to 48). fine: Fine pitch in cents (-50.0 to 50.0).
Inputs: clip_index (required), track_index (required), fine, coarse. Returns: result
set_clip_propertiesA
Set multiple clip properties in a single call.
Only provided properties are changed; omitted ones are left unchanged.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. name: New name for the clip. color: Ableton color palette index. mute: True to mute (deactivate) the clip, False to unmute. gain: Gain value for audio clips. pitch_coarse: Coarse pitch transposition in semitones (-48 to 48). pitch_fine: Fine pitch transposition in cents (-50.0 to 50.0). looping: Enable or disable looping. loop_start: Loop start position in beats. loop_end: Loop end position in beats. start_marker: Start marker position in beats. end_marker: End marker position in beats.
Inputs: clip_index (required), track_index (required), gain, mute, +9 more. Returns: result
set_clip_ram_modeA
Set RAM mode for an audio clip.
When enabled, the clip's audio is loaded into RAM for playback. Only available for audio clips.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. ram_mode: True to enable RAM mode, False to disable.
Inputs: ram_mode (required), clip_index (required), track_index (required). Returns: result
set_clip_slot_colorB
Set the color of a clip slot.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. color: Color value (raw integer color, not color index).
Inputs: color (required), clip_index (required), track_index (required). Returns: result
set_clip_trigger_quantizationA
Set the clip trigger (launch) quantization.
Args: value: Quantization enum value (0=None, 1=1/8, 2=1/4, 3=1/2, 4=1 Bar, 5=2 Bars, 6=4 Bars, 7=8 Bars).
Inputs: value (required). Returns: result
set_clip_velocity_amountA
Set the velocity-to-volume amount for a clip.
Controls how much note velocity affects clip volume.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. velocity_amount: Velocity-to-volume amount (0.0 to 1.0).
Inputs: clip_index (required), track_index (required), velocity_amount (required). Returns: result
set_clip_warpingA
Enable or disable warping on an audio clip.
Warping allows the clip to follow the session tempo. Only available for audio clips.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. warping: True to enable warping, False to disable.
Inputs: warping (required), clip_index (required), track_index (required). Returns: result
set_clip_warp_modeC
Set the warp mode of an audio clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. warp_mode: Warp mode index to set.
Inputs: warp_mode (required), clip_index (required), track_index (required). Returns: result
set_crossfade_assignA
Set the crossfade assignment of a track.
Args: track_index: Zero-based index of the track. assignment: 0 = no crossfade assignment, 1 = assign to A, 2 = assign to B.
Inputs: assignment (required), track_index (required). Returns: result
set_device_parameterA
Set a specific parameter value on a device.
Use get_device_parameters first to discover available parameters and their ranges.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the device in the track's device chain. parameter_index: Zero-based index of the parameter. value: New value for the parameter (must be within the parameter's min/max range).
Inputs: value (required), track_index (required), device_index (required), parameter_index (required). Returns: result
set_draw_modeA
Enable or disable Draw Mode for editing in Ableton Live.
Args: enabled: True to enable, False to disable.
Inputs: enabled (required). Returns: result
set_drum_chain_propertyB
Set a drum-chain-specific property.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the drum rack device. chain_index: Zero-based index of the drum chain. property_name: One of 'in_note', 'out_note', or 'choke_group'. value: Integer value for the target property.
Inputs: value (required), chain_index (required), track_index (required), device_index (required), +1 more. Returns: result
set_drum_pad_muteA
Mute or unmute a specific drum pad in a drum rack.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the drum rack device. pad_index: MIDI note number of the drum pad (0-127). mute: True to mute the pad, False to unmute.
Inputs: mute (required), pad_index (required), track_index (required), device_index (required). Returns: result
set_drum_pad_soloA
Solo or unsolo a specific drum pad in a drum rack.
Args: track_index: Zero-based index of the track. device_index: Zero-based index of the drum rack device. pad_index: MIDI note number of the drum pad (0-127). solo: True to solo the pad, False to unsolo.
Inputs: solo (required), pad_index (required), track_index (required), device_index (required). Returns: result
set_follow_songA
Enable or disable Follow Song mode (auto-scroll to follow playhead).
Args: enabled: True to enable, False to disable.
Inputs: enabled (required). Returns: result
set_groove_amountA
Set the global groove amount.
Args: amount: Groove amount value (0.0 to 1.0).
Inputs: amount (required). Returns: result
set_groove_propertyA
Set a property on a groove.
Args: groove_index: Zero-based index of the groove in the groove pool. property: Property to set. One of: base, quantization_amount, timing_amount, random_amount, velocity_amount. value: New value for the property. For base: 0=1/4, 1=1/8, 2=1/8T, 3=1/16, 4=1/16T, 5=1/32. For amounts: 0.0 to 1.0.
Inputs: value (required), property (required), groove_index (required). Returns: result
set_loop_regionC
Set the loop region and on/off state.
Args: loop_on: Enable or disable looping. loop_start: Loop start position in beats. loop_length: Loop length in beats.
Inputs: loop_on, loop_start, loop_length. Returns: result
set_master_device_parameterA
Set a parameter value on a device on the master track.
Use get_master_device_parameters first to discover available parameters and ranges.
Args: device_index: Zero-based index of the device in the master track's device chain. parameter_index: Zero-based index of the parameter. value: New value for the parameter (must be within the parameter's min/max range).
Inputs: value (required), device_index (required), parameter_index (required). Returns: result
set_master_panA
Set the panning of the master track.
Args: pan: Pan value from -1.0 (full left) to 1.0 (full right). 0.0 is center.
Inputs: pan (required). Returns: result
set_master_volumeA
Set the volume of the master track.
Args: volume: Volume level (0.0 = -inf dB, 0.85 = 0 dB, 1.0 = +6 dB).
Inputs: volume (required). Returns: result
set_metronomeA
Enable or disable the metronome.
Args: on: True to enable, False to disable.
Inputs: on (required). Returns: result
set_midi_recording_quantizationB
Set the MIDI recording quantization.
Args: value: Quantization enum value (0=None, 1=1/4, 2=1/8, 3=1/8T, 4=1/8+T, 5=1/16, 6=1/16T, 7=1/16+T, 8=1/32).
Inputs: value (required). Returns: result
set_presentation_rectC
Set presentation rect for a patcher box.
Inputs: box_id (required), presentation_rect (required), bridge_session_id. Returns: result
set_punch_inA
Enable or disable punch in for recording.
Args: enabled: True to enable punch in, False to disable.
Inputs: enabled (required). Returns: result
set_punch_outA
Enable or disable punch out for recording.
Args: enabled: True to enable punch out, False to disable.
Inputs: enabled (required). Returns: result
set_record_modeA
Enable or disable arrangement recording.
Args: enabled: True to arm recording, False to disarm.
Inputs: enabled (required). Returns: result
set_return_device_parameterA
Set a parameter value on a device on a return track.
Use get_return_device_parameters first to discover available parameters and ranges.
Args: return_index: Zero-based index of the return track. device_index: Zero-based index of the device in the return track's device chain. parameter_index: Zero-based index of the parameter. value: New value for the parameter (must be within the parameter's min/max range).
Inputs: value (required), device_index (required), return_index (required), parameter_index (required). Returns: result
set_return_track_sendA
Set a send value on a return track.
Args: return_index: Zero-based index of the return track. send_index: Zero-based index of the send on the return track. value: Send value (0.0 to 1.0).
Inputs: value (required), send_index (required), return_index (required). Returns: result
set_scaleA
Set the song scale root note and/or scale name (Live 12+).
Args: root_note: MIDI note number for the root (0=C, 1=C#, ..., 11=B). scale_name: Scale name (e.g., 'Major', 'Minor', 'Dorian').
Inputs: root_note, scale_name. Returns: result
set_scene_colorA
Set the color of a scene by color index.
Args: scene_index: Zero-based index of the scene. color_index: Ableton color palette index.
Inputs: color_index (required), scene_index (required). Returns: result
set_scene_nameA
Set the name of a scene.
Args: scene_index: Zero-based index of the scene. name: New name for the scene.
Inputs: name (required), scene_index (required). Returns: result
set_scene_tempoA
Set the tempo for a specific scene.
Pass 0 or a negative value to clear the scene tempo (scene will inherit the song tempo).
Args: scene_index: Zero-based index of the scene. tempo: Tempo in BPM, or -1.0 to clear.
Inputs: tempo (required), scene_index (required). Returns: result
set_scene_time_signatureA
Set the time signature for a specific scene (Live 12+).
Args: scene_index: Zero-based index of the scene. numerator: Time signature numerator (e.g., 4 for 4/4). denominator: Time signature denominator (e.g., 4 for 4/4).
Inputs: numerator (required), denominator (required), scene_index (required). Returns: result
set_selected_sceneA
Set the selected scene in Ableton Live.
Args: scene_index: Zero-based index of the scene to select.
Inputs: scene_index (required). Returns: result
set_selected_trackB
Set the selected track in Ableton Live.
Args: track_index: Zero-based index of the track to select.
Inputs: track_index (required). Returns: result
set_session_automation_recordA
Enable or disable session automation recording.
When enabled, parameter changes during playback are recorded as automation.
Args: enabled: True to enable, False to disable.
Inputs: enabled (required). Returns: result
set_session_recordB
Enable or disable Session Record.
Args: enabled: True to enable Session Record, False to disable it.
Inputs: enabled (required). Returns: result
set_song_timeB
Set the current song time (playhead position) in beats.
Args: time: Position in beats to jump to.
Inputs: time (required). Returns: result
set_tempoA
Set the session tempo in BPM.
Args: tempo: Tempo value between 20 and 999 BPM.
Inputs: tempo (required). Returns: result
set_tempo_follower_enabledA
Enable or disable Tempo Follower.
Args: enabled: True to enable Tempo Follower, False to disable it.
Inputs: enabled (required). Returns: result
set_time_signatureA
Set the song time signature.
Args: numerator: Time signature numerator (e.g., 4 for 4/4). denominator: Time signature denominator (e.g., 4 for 4/4).
Inputs: numerator (required), denominator (required). Returns: result
set_track_armA
Set the record arm state of a track.
Args: track_index: Zero-based index of the track. arm: True to arm for recording, False to disarm.
Inputs: arm (required), track_index (required). Returns: result
set_track_colorA
Set the color of a track by color index.
Args: track_index: Zero-based index of the track. color_index: Ableton color palette index.
Inputs: color_index (required), track_index (required). Returns: result
set_track_input_routingA
Set the input routing for a track.
Use get_track_routing to see available routing type names.
Args: track_index: Zero-based index of the track. routing_type_name: Display name of the desired input routing type. routing_channel_name: Display name of the desired input routing channel (optional).
Inputs: track_index (required), routing_type_name (required), routing_channel_name. Returns: result
set_track_monitoringA
Set the monitoring state of a track.
Args: track_index: Zero-based index of the track. state: Monitoring state (0=In, 1=Auto, 2=Off).
Inputs: state (required), track_index (required). Returns: result
set_track_muteA
Set the mute state of a track.
Args: track_index: Zero-based index of the track. mute: True to mute, False to unmute.
Inputs: mute (required), track_index (required). Returns: result
set_track_nameA
Set the name of a track.
Args: track_index: Zero-based index of the track. name: New name for the track.
Inputs: name (required), track_index (required). Returns: result
set_track_output_routingA
Set the output routing for a track.
Use get_track_routing to see available routing type names.
Args: track_index: Zero-based index of the track. routing_type_name: Display name of the desired output routing type. routing_channel_name: Display name of the desired output routing channel (optional).
Inputs: track_index (required), routing_type_name (required), routing_channel_name. Returns: result
set_track_panA
Set the panning of a track.
Args: track_index: Zero-based index of the track. pan: Pan value from -1.0 (full left) to 1.0 (full right). 0.0 is center.
Inputs: pan (required), track_index (required). Returns: result
set_track_propertiesA
Set multiple track properties in a single call.
Only provided properties are changed; omitted ones are left unchanged.
Args: track_index: Zero-based index of the track. name: New name for the track. volume: Volume value (0.0 to 1.0). pan: Pan value (-1.0 left to 1.0 right). mute: True to mute, False to unmute. solo: True to solo, False to unsolo. arm: True to arm for recording, False to disarm. color: Ableton color palette index.
Inputs: track_index (required), arm, pan, mute, +4 more. Returns: result
set_track_sendA
Set the send level from a track to a return track.
Args: track_index: Zero-based index of the source track. send_index: Zero-based index of the send (corresponds to return track order). value: Send level from 0.0 (off) to 1.0 (full).
Inputs: value (required), send_index (required), track_index (required). Returns: result
set_track_soloA
Set the solo state of a track.
Args: track_index: Zero-based index of the track. solo: True to solo, False to unsolo.
Inputs: solo (required), track_index (required). Returns: result
set_track_volumeA
Set the volume of a track.
Args: track_index: Zero-based index of the track. volume: Volume level (0.0 = -inf dB, 0.85 = 0 dB, 1.0 = +6 dB).
Inputs: volume (required), track_index (required). Returns: result
show_messageA
Display a message in the Ableton Live status bar.
Args: message: Text to display in the status bar.
Inputs: message (required). Returns: result
show_viewB
Show an Ableton UI view.
Args: view_name: View name such as 'Browser', 'Arranger', 'Session', 'Detail', 'Detail/Clip', or 'Detail/DeviceChain'.
Inputs: view_name (required). Returns: result
start_playbackB
Start playing the Ableton Live session.
Inputs: no named parameters. Returns: result
stop_all_clipsA
Stop all playing clips in the session.
Inputs: no named parameters. Returns: result
stop_clipB
Stop playing a clip.
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot.
Inputs: clip_index (required), track_index (required). Returns: result
stop_playbackA
Stop playing the Ableton Live session.
Inputs: no named parameters. Returns: result
tap_tempoC
Tap tempo to set the BPM by tapping.
Inputs: no named parameters. Returns: result
toggle_browseA
Toggle Ableton's browser hot-swap mode for the selected device.
Inputs: no named parameters. Returns: result
toggle_presentation_modeC
Toggle or set the attached patcher's presentation mode.
Inputs: enabled, bridge_session_id. Returns: result
trigger_back_to_arrangementA
Trigger back to arrangement.
Deactivates all session clip playback and returns to the arrangement view playback. Equivalent to clicking the 'Back to Arrangement' button in Ableton.
Inputs: no named parameters. Returns: result
trigger_recordB
Trigger session record in Ableton Live.
Inputs: no named parameters. Returns: result
undoA
Undo the last action in Ableton Live.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 220 tools
Many tools have clear, distinct purposes, but there is notable overlap between pairs like add_notes_to_clip/add_notes_extended, get_notes_from_clip/get_notes_extended, set_track_volume vs set_track_properties, and the various device parameter getters. These overlapping tool pairs create potential misselection, though descriptions do help clarify which to prefer.
The vast majority of tools follow a consistent snake_case verb_noun pattern (get_track_info, set_track_volume, create_scene). Minor deviations like 'duplicate_to_arrangement', 'trigger_back_to_arrangement', and 'toggle_browse' are few and still readable, so the pattern is largely predictable.
With 220 tools, the server far exceeds any reasonable scope for a single MCP instance. Even for a DAW control server, this is an extreme number that will overwhelm agents and make tool selection expensive and error-prone.
The tool surface covers an extremely wide range of Ableton Live functionality: transport, tracks, scenes, clips, devices, parameters, browser loading, Max patcher manipulation, and docs. Minor gaps exist (e.g., no arrangement clip envelope editing, no project save/export), but the core workflows are well covered.
Related MCP Connectors
OSC ↔ MIDI bridge for synthesizers and DAWs, with the SynthHub catalogue. A MIDI MCP and OSC MCP.
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Related MCP Servers
- FlicenseBqualityDmaintenanceMCP server for controlling Ableton Live, enabling AI assistants to interact with Live sessions through tools for track/clip/scene management, playback control, and device parameter adjustments.48-
- AlicenseNot gradedqualityCmaintenanceAn MCP server to control Ableton Live via the Live API, offering curated tools for transport, tracks, clips, devices, automation, and more, plus a generic layer to access the entire Live Object Model.1MIT
- AlicenseAqualityBmaintenanceEnables an MCP client to inspect and modify a running digital audio workstation session through a local Python remote-script TCP bridge, exposing tools for session and track structure, clip slots and MIDI notes, devices and browser items, and mixer/transport control. Read and bulk-write operations cover tempo, naming, clip creation and note editing, muting/soloing/arming, playback and scene launching, and device parameter loading and adjustment.322MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to control Ableton Live through a Max for Live device and optional Remote Script, covering tracks, clips, MIDI notes, mixer settings, transport, and plugin search and insertion.1MIT