Skip to main content
Glama

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__.py

Windows (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

  1. Open (or restart) Ableton Live

  2. Go to Preferences > Link, Tempo & MIDI

  3. Under Control Surface, select AbletonMCP from the dropdown

  4. 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-mcp

Available Tools

Tool

Description

get_session_info

Get tempo, time signature, track counts

get_track_info

Get track details (name, volume, pan, clips, devices)

create_midi_track

Create a new MIDI track

create_audio_track

Create a new audio track

delete_track

Delete a track

delete_all_tracks

Delete all tracks (clear session)

set_track_name

Rename a track

set_track_volume

Set track volume (0.0–1.0)

set_track_pan

Set track pan (-1.0–1.0)

set_track_mute

Mute/unmute a track

set_track_solo

Solo/unsolo a track

create_clip

Create an empty MIDI clip

add_notes_to_clip

Add MIDI notes to a clip

set_clip_name

Rename a clip

fire_clip

Start playing a clip

stop_clip

Stop a clip

get_clip_notes

Read MIDI notes from a session clip

get_clip_info

Get clip details (name, length, loop points)

duplicate_clip_to_scene

Duplicate a session clip to another scene

delete_clip

Delete a clip from a session clip slot

create_scene

Create a new scene

delete_scene

Delete a scene

set_scene_name

Rename a scene

fire_scene

Fire all clips in a scene

start_playback

Start session playback

stop_playback

Stop session playback

set_tempo

Set tempo in BPM

set_time_signature

Set time signature (e.g. 5/4, 7/8)

undo

Trigger Ableton's undo

get_browser_tree

Browse instruments/effects categories

get_browser_items_at_path

List items at a browser path

load_instrument_or_effect

Load a device onto a track

create_midi_track_with_instrument

Create a MIDI track and load an instrument in one step

load_drum_kit

Load a drum rack and kit

get_device_parameters

List all parameters of a device

set_device_parameter

Set a device parameter value

get_arrangement_clips

List clips on the arrangement timeline

create_arrangement_clip

Create a MIDI clip on the arrangement timeline

delete_arrangement_clip

Delete an arrangement clip

duplicate_arrangement_clip

Duplicate an arrangement clip to a new position

get_arrangement_clip_notes

Read MIDI notes from an arrangement clip

set_arrangement_clip_notes

Set MIDI notes on an arrangement clip

set_song_time

Set the playback cursor position

get_arrangement_loop

Get the arrangement loop brace

set_arrangement_loop

Set the arrangement loop brace

back_to_arranger

Switch from session to arrangement playback

duplicate_session_to_arrangement

Copy a session clip to the arrangement

session_to_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 Ableton

Available Tools

48 tools
add_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

    B3.1/5.0

    Scored across 48 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    48 tools is high but justified by the complexity of a DAW. Covers track, clip, scene, arrangement, browser, and device management without feeling bloated.

    Completeness4/5

    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

    Related MCP Servers