Skip to content
Back to search

ableton-live-mcp

Just another ableton mcp server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marcjohnce--ableton-live-mcp/badge.svg)](/listings/marcjohnce--ableton-live-mcp)

HTML

<a href="/listings/marcjohnce--ableton-live-mcp"><img src="/api/listings/marcjohnce--ableton-live-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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+)

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):

{
  "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."*

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 97 lines
  1. # Ableton Live 12 MCP Server
  2. 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.
  3. It has two parts:
  4. ```
  5. Claude ⇄ (MCP, stdio) ⇄ ableton-live-mcp (Python) ⇄ (JSON over TCP 127.0.0.1:9877) ⇄ AbletonMCP Remote Script (inside Live)
  6. ```
  7. ## What it can do (≈110 tools)
  8. | Area | Tools |
  9. |---|---|
  10. | **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` |
  11. | **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` |
  12. | **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` |
  13. | **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` |
  14. | **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` |
  15. | **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 |
  16. | **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` |
  17. | **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) |
  18. | **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) |
  19. | **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` |
  20. | **Escape hatch** | `ableton_raw_command` |
  21. ## Install
  22. ### 1. Remote Script (inside Live)
  23. 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):
  24. - **macOS:** `~/Music/Ableton/User Library/Remote Scripts/AbletonMCP`
  25. - **Windows:** `%USERPROFILE%\Documents\Ableton\User Library\Remote Scripts\AbletonMCP`
  26. 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".
  27. ### 2. MCP server (Python 3.10+)
  28. ```bash
  29. cd ableton-live-mcp
  30. pip install -e ".[analysis]" # core + audio analysis
  31. pip install -e ".[analysis,stems]" # + Demucs stem separation (large, pulls PyTorch)
  32. ```
  33. Or with uv: `uv pip install -e ".[analysis]"`.
  34. ### 3. Connect your MCP client
  35. **Claude Desktop** — add this to `claude_desktop_config.json` (Settings → Developer → Edit Config):
  36. ```json
  37. {
  38. "mcpServers": {
  39. "ableton-live": {
  40. "command": "/full/path/to/python",
  41. "args": ["-m", "ableton_mcp"]
  42. }
  43. }
  44. }
  45. ```
  46. 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"]`.
  47. **Claude Code:** `claude mcp add ableton-live -- python -m ableton_mcp`
  48. Restart the client and ask: *"Check the Ableton connection."*
  49. ## Example prompts
  50. - "Make a 124 BPM deep house idea in F minor: drums, a syncopated bass, Rhodes-style chords and a sparse lead."
  51. - "Build a full techno track in A minor and lay it out in the arrangement with locators."
  52. - "Humanize the hats by 6 ms and ±12 velocity, then quantize the chords to 1/16 at 70% with a bit of swing."
  53. - "Create a breakdown and a build with a filter sweep, then try two different arrangement structures."
  54. - "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."
  55. - "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."
  56. - "Scan ~/Samples for loops in A minor or compatible keys between 120–128 BPM and find the ones that fit my current mix best."
  57. - "Show me the spectrogram of the vocal clip on track 3."
  58. - "Make a sample pack from ~/Music/my_song.wav."
  59. ## Notes and limits
  60. - **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).
  61. - **Audio export:** Live's API cannot render audio. Loudness, reference and stem tools work on files you export (File → Export Audio/Video).
  62. - **Meters:** `measure_levels`/`balance_levels` use Live's meter scale (not exact dB), so treat them as relative balancing.
  63. - **Sidechain:** routing is set automatically where Live exposes Compressor sidechain routing; otherwise the tool tells you which source to pick.
  64. - **Plugins:** third-party plugin parameters are visible once Live exposes them (click "Configure" on the plugin for more).
  65. - **Pack maker:** use it only on audio you have the rights to. Without Demucs, loops are cut from the full mix.
  66. - **Port:** set `ABLETON_MCP_PORT` (in the environment Live and the server see) to change it from 9877.
  67. - **Logs:** Live's `Log.txt` (Preferences folder) contains Remote Script errors.
  68. ## Development
  69. ```bash
  70. pip install -e ".[analysis,dev]"
  71. pytest tests # runs the full stack against a fake Live object model
  72. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.