Skip to main content
Glama
Ableton Live 12 MCP Server

Ableton Live 12 MCP Server

by marcjohnce
README.md
# Ableton Live 12 MCP Server

Let Claude (or any MCP client) produce music in Ableton Live 12: write drums, basslines, chords and melodies; build song sections and full arrangements; edit clips; mix; master; analyse audio; and make sample packs.

It has two parts:

```
Claude ⇄ (MCP, stdio) ⇄ ableton-live-mcp (Python)  ⇄ (JSON over TCP 127.0.0.1:9877) ⇄ AbletonMCP Remote Script (inside Live)
```

## What it can do (≈110 tools)

| Area | Tools |
|---|---|
| **Session & transport** | `get_session_overview`, `get_track_info`, `get_clip_info`, `get_scenes`, `get_selection`, `play`, `stop`, `set_tempo`, `set_time_signature`, `set_metronome`, `set_arrangement_loop`, `go_to_bar`, `undo`/`redo`, `set_record_mode`, `capture_midi`, `show_view` |
| **Tracks & routing** | `create_track` (midi/audio/return, with an instrument), `delete_track`, `duplicate_track`, `set_track_properties`, `set_track_volume` (dB), `set_track_pan`, `set_track_send`, `get_routing_options`, `set_track_routing`, `select_track` |
| **Clips & MIDI** | `create_midi_clip`, `create_audio_clip`, `duplicate_clip`, `set_clip_properties` (loop, markers, warp mode…), `set_clip_gain` (dB), `set_audio_clip_pitch`, `get_notes`/`add_notes`/`replace_notes`/`remove_notes`, `quantize_clip` (grid, strength, swing), `humanize_clip` (timing in ms, velocity, length), `transpose_clip` (MIDI or audio), `shape_velocity` (scale, compress, accents, ramps), `fit_clip_to_scale`, `edit_clip_rhythm` (legato, double/half speed, reverse, shift), `create_clip_variation`, `get_warp_markers`, `set_clip_automation`, `clear_clip_automation` |
| **Composition** | `generate_drums` (21 styles from house to drill, with fills, swing, intensity), `generate_bassline` (11 styles incl. 808, rolling, acid), `generate_chords` (voice-led; stabs, offbeat, strum…), `generate_melody` (motif-based), `generate_arpeggio`, `build_song_section` (intro/verse/build/drop/breakdown/chorus/bridge/outro), `build_song` (whole song plus arrangement), `add_filter_sweep`, `list_styles` |
| **Arrangement** | `arrange_scenes` (scenes → arrangement with locators; templates for quick structure passes), `clip_to_arrangement`, `create_arrangement_midi_clip`, `place_audio_in_arrangement`, `get_arrangement_clips`, `clear_arrangement`, `add_locator`, `delete_locator`, `jump_to_locator`, `get_locators` |
| **Devices & browser** | `insert_device` (any native device by name), `get_device_parameters`, `set_device_parameter` (raw values, **display units** such as Hz/dB/ms, or option names), `set_device_parameters`, `set_device_enabled`, `delete_device`, `get_drum_pads`, `get_sample_info` (Simpler/Sampler), `search_browser`, `browse`, `load_browser_item`, `get_browser_categories` — works with third-party plugins (Serum, FabFilter…) through their exposed parameters |
| **Mixing** | `high_pass_track`, `high_pass_tops`, `add_sidechain` (Compressor sidechained to the kick), `setup_send_effects` (Reverb/Delay returns plus send levels), `spread_stereo`, `measure_levels` (live meters), `balance_levels` |
| **Mastering** | `build_master_chain` (EQ Eight → Glue Compressor → Limiter; clean/warm/loud/streaming), `check_master_loudness` (LUFS/true peak of an export, then adjusts the limiter towards a target), `match_reference` (loudness, tonal balance, width and dynamics against a reference; can apply EQ), `master_audio_file` (offline master of a final file to a target LUFS) |
| **Analysis** | `analyze_audio` (key and Camelot, BPM, integrated LUFS, true peak, crest, LRA, 7-band energy, brightness, rhythmic density, syncopation, stereo width, plus an optional **waveform + spectrogram image**), `analyze_clip_audio`, `detect_key_and_bpm`, `scan_library` (find samples by key, compatible keys, BPM, loop/one-shot, role; cached index), `session_frequency_map`, `find_fitting_samples` (**anti-clash** scoring: samples that fill open frequency areas), `analyze_stems` (clashes and warnings) |
| **Sample packs** | `separate_stems` (Demucs), `chop_into_loops` (bar-aligned, named with BPM and key), `extract_one_shots` (de-duplicated, named by role), `make_sample_pack` (song → stems → loops + one-shots + metadata), `generate_loop_from_one_shots` (renders an original loop and can drop it into Live), `load_sample_to_track` |
| **Escape hatch** | `ableton_raw_command` |

## Install

### 1. Remote Script (inside Live)

Run `python install_remote_script.py`, or copy the folder `remote_script/AbletonMCP` to your User Library's Remote Scripts folder (create the folder if it does not exist):

- **macOS:** `~/Music/Ableton/User Library/Remote Scripts/AbletonMCP`
- **Windows:** `%USERPROFILE%\Documents\Ableton\User Library\Remote Scripts\AbletonMCP`

Restart Live, then go to **Settings → Link, Tempo & MIDI → Control Surface** and choose **AbletonMCP** (leave Input/Output as None). Live's status bar shows "AbletonMCP: listening on port 9877".

### 2. MCP server (Python 3.10+)

```bash
cd ableton-live-mcp
pip install -e ".[analysis]"          # core + audio analysis
pip install -e ".[analysis,stems]"    # + Demucs stem separation (large, pulls PyTorch)
```

Or with uv: `uv pip install -e ".[analysis]"`.

### 3. Connect your MCP client

**Claude Desktop** — add this to `claude_desktop_config.json` (Settings → Developer → Edit Config):

```json
{
  "mcpServers": {
    "ableton-live": {
      "command": "/full/path/to/python",
      "args": ["-m", "ableton_mcp"]
    }
  }
}
```

Use the Python that you installed the package into (`which python` / `where python`). With uv you can instead use `"command": "uv", "args": ["--directory", "/path/to/ableton-live-mcp", "run", "ableton-live-mcp"]`.

**Claude Code:** `claude mcp add ableton-live -- python -m ableton_mcp`

Restart the client and ask: *"Check the Ableton connection."*

## Example prompts

- "Make a 124 BPM deep house idea in F minor: drums, a syncopated bass, Rhodes-style chords and a sparse lead."
- "Build a full techno track in A minor and lay it out in the arrangement with locators."
- "Humanize the hats by 6 ms and ±12 velocity, then quantize the chords to 1/16 at 70% with a bit of swing."
- "Create a breakdown and a build with a filter sweep, then try two different arrangement structures."
- "Sidechain the bass and pads to the kick, high-pass everything except kick and bass at 150 Hz, and set up reverb and delay sends."
- "Put a loud master chain on. I exported the mix to ~/Desktop/mix.wav — get it to −8 LUFS and compare it to ~/Music/ref.wav."
- "Scan ~/Samples for loops in A minor or compatible keys between 120–128 BPM and find the ones that fit my current mix best."
- "Show me the spectrogram of the vocal clip on track 3."
- "Make a sample pack from ~/Music/my_song.wav."

## Notes and limits

- **Live versions:** built for Live 12. `insert_device` uses Live 12.3+'s `insert_device`, falling back to the browser on older 12.x. Arrangement MIDI clips need 12.1.10+. Everything else works on any Live 12 (most of it also on Live 11).
- **Audio export:** Live's API cannot render audio. Loudness, reference and stem tools work on files you export (File → Export Audio/Video).
- **Meters:** `measure_levels`/`balance_levels` use Live's meter scale (not exact dB), so treat them as relative balancing.
- **Sidechain:** routing is set automatically where Live exposes Compressor sidechain routing; otherwise the tool tells you which source to pick.
- **Plugins:** third-party plugin parameters are visible once Live exposes them (click "Configure" on the plugin for more).
- **Pack maker:** use it only on audio you have the rights to. Without Demucs, loops are cut from the full mix.
- **Port:** set `ABLETON_MCP_PORT` (in the environment Live and the server see) to change it from 9877.
- **Logs:** Live's `Log.txt` (Preferences folder) contains Remote Script errors.

## Development

```bash
pip install -e ".[analysis,dev]"
pytest tests            # runs the full stack against a fake Live object model
```