ableton-mcp
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-mcp add a piano track"
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-mcp
MCP server for controlling Ableton Live — enabling AI assistants to interact with Live sessions via the Model Context Protocol.
Prerequisites
Ableton Live 10+
Related MCP server: ableton-mind
Setup
1. Install the Control Surface
A control surface script must be installed into Ableton Live. It runs inside Live and exposes a TCP socket for the MCP server to connect to.
macOS:
mkdir -p ~/Music/Ableton/User\ Library/Remote\ Scripts/AbletonMCP && curl -fsSL https://raw.githubusercontent.com/amamparo/ableton-mcp/main/control_surface/AbletonMCP/__init__.py -o ~/Music/Ableton/User\ Library/Remote\ Scripts/AbletonMCP/__init__.pyWindows (PowerShell):
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\Documents\Ableton\User Library\Remote Scripts\AbletonMCP" | Out-Null; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/amamparo/ableton-mcp/main/control_surface/AbletonMCP/__init__.py" -OutFile "$env:USERPROFILE\Documents\Ableton\User Library\Remote Scripts\AbletonMCP\__init__.py"2. Enable in Ableton Live
Open (or restart) Ableton Live
Go to Preferences > Link, Tempo & MIDI
Under Control Surface, select AbletonMCP from the dropdown
You should see "AbletonMCP: Listening on port 9877" in Ableton's log
3. Configure the MCP Client
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"ableton-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/amamparo/ableton-mcp", "ableton-mcp"]
}
}
}To pin to a specific version:
{
"mcpServers": {
"ableton-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/amamparo/ableton-mcp@v0.1.0", "ableton-mcp"]
}
}
}Claude Code:
claude mcp add ableton-mcp -- uvx --from "git+https://github.com/amamparo/ableton-mcp" ableton-mcpAvailable Tools
Tool | Description |
| Get tempo, time signature, track counts |
| Get track details (name, volume, pan, clips, devices) |
| Create a new MIDI track |
| Create a new audio track |
| Delete a track |
| Delete all tracks (clear session) |
| Rename a track |
| Set track volume (0.0–1.0) |
| Set track pan (-1.0–1.0) |
| Mute/unmute a track |
| Solo/unsolo a track |
| Create an empty MIDI clip |
| Add MIDI notes to a clip |
| Rename a clip |
| Start playing a clip |
| Stop a clip |
| Read MIDI notes from a session clip |
| Get clip details (name, length, loop points) |
| Duplicate a session clip to another scene |
| Delete a clip from a session clip slot |
| Create a new scene |
| Delete a scene |
| Rename a scene |
| Fire all clips in a scene |
| Start session playback |
| Stop session playback |
| Set tempo in BPM |
| Set time signature (e.g. 5/4, 7/8) |
| Trigger Ableton's undo |
| Browse instruments/effects categories |
| List items at a browser path |
| Load a device onto a track |
| Create a MIDI track and load an instrument in one step |
| Load a drum rack and kit |
| List all parameters of a device |
| Set a device parameter value |
| List clips on the arrangement timeline |
| Create a MIDI clip on the arrangement timeline |
| Delete an arrangement clip |
| Duplicate an arrangement clip to a new position |
| Read MIDI notes from an arrangement clip |
| Set MIDI notes on an arrangement clip |
| Set the playback cursor position |
| Get the arrangement loop brace |
| Set the arrangement loop brace |
| Switch from session to arrangement playback |
| Copy a session clip to the arrangement |
| Lay out scenes sequentially on the arrangement |
Note: Automation breakpoints are not available via the control surface API. Arrangement view features require Ableton Live 11+.
Development
just install # Install dependencies
just check # Run lint + tests
just fmt # Auto-format code
just install-control-surface # Install control surface to AbletonAvailable Tools
48 toolsadd_notes_to_clipA
Add MIDI notes to a clip. Each note is a dict with keys: pitch (0-127), start_time (beats), duration (beats), velocity (0-127, default 100), mute (bool, default false). By default this replaces all existing notes in the clip. Set append=true to keep existing notes and add the new ones on top.
Inputs: track_index (required), clip_index (required), notes (required), append. Returns: result
back_to_arrangerA
Switch playback from session view back to the arrangement. Stops all session clips and resumes arrangement playback.
Inputs: no named parameters. Returns: result
create_arrangement_clipC
Create an empty MIDI clip on the arrangement timeline. start_time and length are in beats.
Inputs: track_index (required), start_time (required), length (required). Returns: result
create_audio_trackB
Create a new audio track. Use index=-1 to append at the end.
Inputs: index. Returns: result
create_clipC
Create an empty MIDI clip in a clip slot. Length is in beats.
Inputs: track_index (required), clip_index (required), length. Returns: result
create_midi_trackB
Create a new MIDI track. Use index=-1 to append at the end.
Inputs: index. Returns: result
create_midi_track_with_instrumentA
Create a new MIDI track and load an instrument in a single operation. Faster than separate create_midi_track + load_instrument_or_effect calls. Use index=-1 to append at the end. Optionally set the track name. IMPORTANT: load instruments sequentially, not in parallel.
Inputs: uri (required), index, name. Returns: result
create_sceneA
Create a new empty scene. Use index=-1 to append at the end. Adds a new clip slot row across all tracks.
Inputs: index. Returns: result
delete_all_tracksA
Delete all tracks except one. Useful for clearing a session before building a fresh arrangement. Returns the count of deleted tracks.
Inputs: no named parameters. Returns: result
delete_arrangement_clipB
Delete a clip from the arrangement timeline. Use get_arrangement_clips to find the clip_index.
Inputs: track_index (required), clip_index (required). Returns: result
delete_clipC
Delete a clip from a session clip slot.
Inputs: track_index (required), clip_index (required). Returns: result
delete_sceneB
Delete a scene by index. Cannot delete the last scene.
Inputs: scene_index (required). Returns: result
delete_trackC
Delete a track by index.
Inputs: track_index (required). Returns: result
duplicate_arrangement_clipC
Duplicate an arrangement clip to a new position on the timeline. destination_time is in beats.
Inputs: track_index (required), clip_index (required), destination_time (required). Returns: result
duplicate_clip_to_sceneA
Duplicate a session clip from one scene to another on the same track. The destination clip slot must be empty.
Inputs: track_index (required), source_clip_index (required), dest_clip_index (required). Returns: result
duplicate_session_to_arrangementC
Copy a session view clip to the arrangement timeline. destination_time is the position in beats where the clip will be placed.
Inputs: track_index (required), clip_index (required), destination_time (required). Returns: result
fire_clipC
Start playing a clip.
Inputs: track_index (required), clip_index (required). Returns: result
fire_sceneB
Fire all clips in a scene simultaneously.
Inputs: scene_index (required). Returns: result
get_arrangement_clip_notesB
Read all MIDI notes from an arrangement clip. Returns a list of notes with pitch, start_time, duration, velocity, and mute.
Inputs: track_index (required), clip_index (required). Returns: result
get_arrangement_clipsC
Get all clips on the arrangement timeline for a track. Returns each clip's index, name, start_time, end_time, and length in beats. Requires Ableton Live 11+.
Inputs: track_index (required). Returns: result
get_arrangement_loopA
Get the arrangement loop brace position and length in beats.
Inputs: no named parameters. Returns: result
get_browser_items_at_pathA
List items at a browser path. Paths can start with a top-level category (e.g. 'Sounds/Bass', 'Instruments/Analog', 'Audio Effects/Reverb') or use a bare subcategory name (e.g. 'Bass'). Use get_browser_tree first to discover available categories.
Inputs: path (required). Returns: result
get_browser_treeB
Browse Ableton's instrument and effect categories. category_type can be: all, instruments, audio_effects, midi_effects, sounds, drums, max_for_live.
Inputs: category_type. Returns: result
get_clip_infoC
Get detailed info about a session clip: name, length, loop_start, loop_end, is_playing, is_recording.
Inputs: track_index (required), clip_index (required). Returns: result
get_clip_notesA
Read all MIDI notes from a session clip. Returns a list of notes with pitch, start_time, duration, velocity, and mute.
Inputs: track_index (required), clip_index (required). Returns: result
get_device_parametersA
List all parameters of a device on a track. Returns device_name and a list of parameters with name, value, min, max.
Inputs: track_index (required), device_index (required). Returns: result
get_session_infoA
Get current Ableton Live session info: tempo, time signature, track counts, and master track details.
Inputs: no named parameters. Returns: result
get_track_infoB
Get detailed info about a track: name, type, mute/solo/arm state, volume, pan, clip slots, and devices.
Inputs: track_index (required). Returns: result
load_drum_kitA
Load a drum rack and then load a specific kit into it. First loads the rack by URI, then navigates to kit_path to load the kit preset.
Inputs: track_index (required), rack_uri (required), kit_path (required). Returns: result
load_instrument_or_effectA
Load an instrument or effect onto a track by its browser URI. Use get_browser_tree and get_browser_items_at_path to find URIs. Returns the loaded device_name so you can verify the correct device was loaded. Set clear_existing=true to remove all existing devices from the track before loading — recommended when replacing an instrument on a non-empty track. IMPORTANT: load instruments sequentially, not in parallel. Concurrent loads will fail or land on the wrong track.
Inputs: track_index (required), uri (required), clear_existing. Returns: result
session_to_arrangementA
Lay out session view scenes sequentially on the arrangement timeline. Takes a list of scene indices and places each scene's clips end-to-end starting from beat 0. Use this to build a full song structure from session view clips.
Inputs: scene_indices (required). Returns: result
set_arrangement_clip_notesA
Set MIDI notes on an arrangement clip. Replaces all existing notes. Each note is a dict with keys: pitch (0-127), start_time (beats), duration (beats), velocity (0-127, default 100), mute (bool, default false).
Inputs: track_index (required), clip_index (required), notes (required). Returns: result
set_arrangement_loopB
Set the arrangement loop brace. start and length are in beats.
Inputs: start (required), length (required). Returns: result
set_clip_nameC
Rename a clip.
Inputs: track_index (required), clip_index (required), name (required). Returns: result
set_device_parameterA
Set a device parameter value. Value is clamped to the parameter's min/max range. Use get_device_parameters to discover available parameters.
Inputs: track_index (required), device_index (required), param_index (required), value (required). Returns: result
set_scene_nameC
Rename a scene (the label in the Master track column).
Inputs: scene_index (required), name (required). Returns: result
set_song_timeB
Set the playback cursor position in beats.
Inputs: time (required). Returns: result
set_tempoB
Set the session tempo in BPM.
Inputs: tempo (required). Returns: result
set_time_signatureB
Set the song's time signature (e.g. 4/4, 5/4, 7/8).
Inputs: numerator (required), denominator (required). Returns: result
set_track_muteC
Mute or unmute a track.
Inputs: track_index (required), mute (required). Returns: result
set_track_nameD
Rename a track.
Inputs: track_index (required), name (required). Returns: result
set_track_panB
Set track pan. Range: -1.0 (full left) to 1.0 (full right), 0.0 is center.
Inputs: track_index (required), pan (required). Returns: result
set_track_soloC
Solo or unsolo a track.
Inputs: track_index (required), solo (required). Returns: result
set_track_volumeC
Set track volume. Range: 0.0 (silence) to 1.0 (max).
Inputs: track_index (required), volume (required). Returns: result
start_playbackC
Start session playback.
Inputs: no named parameters. Returns: result
stop_clipC
Stop a playing clip.
Inputs: track_index (required), clip_index (required). Returns: result
stop_playbackA
Stop session playback.
Inputs: no named parameters. Returns: result
undoA
Trigger Ableton's undo. Safety net for destructive operations.
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 48 tools
Most tools have distinct purposes, with clear separation between session and arrangement operations. Minor overlap exists (e.g., create_midi_track vs create_midi_track_with_instrument) but descriptions resolve ambiguity.
Tools follow a consistent verb_noun pattern in snake_case (e.g., create_clip, set_tempo, get_track_info). The naming is predictable and aids understanding.
48 tools is high but justified by the complexity of a DAW. Covers track, clip, scene, arrangement, browser, and device management without feeling bloated.
Covers core workflows: creation, deletion, editing, playback, and browsing. Minor gaps like explicit note deletion or quantize are handled indirectly (e.g., add_notes replaces all).
Related MCP Connectors
MCP server for Producer/Riffusion AI music generation
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceMCP server that enables AI agents to read and edit Ableton Live sets, including tracks, clips, MIDI notes, devices, and scenes.1-
- AlicenseAqualityCmaintenanceMCP server for Ableton Live that exposes the Live Object Model to LLMs, enabling natural language control of music production.3660 npm12MIT
- AlicenseAqualityDmaintenanceMCP server that bridges Ableton Live with AI models, enabling real-time project inspection and control such as track overview, device parameters, and audio analysis.1273 PyPI1MIT
- AlicenseAqualityCmaintenanceAn MCP server that enables AI assistants to control Ableton Live, providing 104 tools for music production including track, clip, device, and mixer control.1561,034 PyPI80MIT