mcp-server-ableton-live
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ableton-mcp--datarat
An MCP server for driving Ableton Live 11/12 from Claude (or any MCP client), maintained by datarat as a working tool for writing and producing electronic music: chords, drums, bass design, arrangement and automation.
A Remote Script runs inside Live and exposes the Live API over a local socket. The
MCP server turns that into 156 typed, validated tools, plus offline tools that read
and diff saved .als / .adg files with Live closed.
What's different in this fork
write_automationdraws real shapes. Each point holds its value until the next point, and the last point holds to the clip end. Two points give a flat line with one step, dense points (about every 1/16 beat) give a smooth ramp, and a pair of points a hair apart gives an instant jump. Upstream drew every point as a zero-length spike. Verified in Live 12.4.Version tag
1.8.1+datarat.N, sodoctorandget_session_info(bridge_version) show which build is running.
See CHANGELOG.md for details.
Related MCP server: Ableton MCP for Live Intro
Known limits of the Live API
Ramps are staircases. A script can only write flat steps (
insert_step); it cannot place a single breakpoint that Live slopes into the next one, or delete one. For a smooth curve, send dense points. For a perfectly straight line, draw two breakpoints by hand.Arrangement clips can't take envelopes from a script.
duplicate_to_arrangementplaces the clip, but Live refusescreate_automation_envelopeon Arrangement clips, so Session envelopes are not carried over (the tool reports this). To get them into the Arrangement, record the Session clip withrecord_section, or draw them by hand.No render, export or freeze: those stay manual.
Setup
You need Ableton Live 11 or 12, Python 3.10+, and uv.
1. Register the server (Claude Code):
claude mcp add AbletonMCP -s user -- uvx --from git+https://github.com/datarat-sound/ableton-mcp--datarat@main-datarat mcp-server-ableton-liveOther clients (Claude Desktop, Cursor), in the mcpServers block:
{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/datarat-sound/ableton-mcp--datarat@main-datarat",
"mcp-server-ableton-live"
]
}
}
}If uv picks a broken Python, pin one with uvx --python 3.14 ....
2. Install the Remote Script into your User Library:
uvx --from git+https://github.com/datarat-sound/ableton-mcp--datarat@main-datarat mcp-server-ableton-live installAdd --user-library "/path/to/User Library" if your library is not in the default
place (for example on another drive), and --replace to overwrite an older script
(a backup is kept). Rerun this after every update so the Live side matches the server.
3. Turn it on in Live. Restart Live, open Settings > Tempo & MIDI (older versions: Link, Tempo & MIDI), and in an empty Control Surface row pick AbletonMCP with Input and Output set to None.
4. Check it.
uvx --from git+https://github.com/datarat-sound/ableton-mcp--datarat@main-datarat mcp-server-ableton-live doctor --jsonUse the same --user-library here as for install.
Tools
Area | Covers |
Session and transport | session info and snapshot, play/stop, tempo, time signature, loop, locators, scenes, undo/redo, capture MIDI, song scale, groove and swing |
Tracks and mixer | create/delete MIDI, audio and return tracks, volume, pan, mute, solo, arm, sends, routing, meters, take lanes |
Clips and notes | create clips, write and edit MIDI notes, quantize, groove, loop, clip automation |
Devices | browse and load instruments/effects (including Master and Returns), read and set parameters, racks and macros, Simpler, drum pads |
Arrangement | place, list and delete Arrangement clips, record a section to WAV |
Generators | drums, Euclidean rhythms, chord progressions and voicings, melodies, basslines, humanize |
Analysis | key detection, mix scan, session diff, audio file peak/RMS |
Offline | summarize, extract MIDI, detect key and diff saved |
Batch | many edits in one round trip and one undo step |
Set ABLETON_TOOLSETS to load only some groups, for example
ABLETON_TOOLSETS=session,tracks,clips,devices. Groups: session, tracks, clips,
devices, browser, arrangement, generators, audio, analysis, offline,
recipes. Unset loads everything.
Conventions
Indices are 0-based. Times and lengths are in beats. Volume uses Live's 0.0–1.0 fader range, where 0.85 is 0 dB.
Device parameters use their own native ranges: read
get_device_parametersfirst.add_notes_to_clipreplaces all notes;edit_noteschanges a few.duplicate_to_arrangementoverwrites whatever is under the destination.Transport replies report the state before the command; confirm with
get_session_info.
Troubleshooting
AbletonMCP missing from Control Surfaces: the folder must be named exactly
AbletonMCP, and Live only scans at startup, so restart Live.Every command times out: a dialog is open in Live (on the trial, the startup nag). Dismiss it and retry.
Port 9877 not listening: Live isn't running or the Control Surface isn't set. If another program uses 9877, set
ABLETON_MCP_PORTfor Live andABLETON_PORTfor the server.
Security
The Remote Script listens on 127.0.0.1:9877 with no authentication. Keep it on
loopback and don't forward the port. See SECURITY.md.
Development
ableton_live_mcp/
server.py entrypoint: MCP server or a setup subcommand
app.py FastMCP app, lifecycle, server instructions
connection.py socket client to the Remote Script
cli.py install / uninstall / doctor
tools/ the MCP tools, grouped by area
remote_script/ the Live-side script and its command dispatch
tests/ protocol, dispatch-contract and registration tests (no Live needed)uv run --extra dev pytest
uvx ruff check .Remote Script changes only reach Live after install --replace and a Live restart.
Credits and license
Maintained by datarat. Forked from wstierhout/ableton-live-mcp (Wouter Stierhout), which builds on the original AbletonMCP by Siddharth Ahuja. MIT licensed; see LICENSE.
Ableton and Live are trademarks of Ableton AG. This project is not affiliated with or endorsed by Ableton.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and edit DAW projects as an agent, save native Logic projects, convert projects between DAWs
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- FlicenseBqualityDmaintenanceControl Ableton Live from Claude Code via the Model Context Protocol (MCP). Create/edit tracks, control plugins, fire clips, edit MIDI notes, capture audio — all through natural language.100-
- AlicenseCqualityBmaintenanceEnables Claude or any AI agent to operate Live 12 Intro end to end: creating tracks and scenes, writing and quantizing MIDI clips, loading audio onto the Arrangement timeline, setting device parameters in real units, drawing clip automation, mixing with real sidechain, and rendering or analyzing audio so the agent can check its own work. It exposes 57 tools over MCP or a local JSON socket, working within the stock Intro edition's 16-track, 16-scene limits.57MIT
- AlicenseNot gradedqualityCmaintenanceEnables any MCP client to control Ableton Live 12 through 56 tools covering tracks, clips, MIDI notes, devices and racks, mixer parameters, transport, browser loading, automation, and arrangement editing. It also provides optional audio analysis (key, chords, groove, transcription, stem separation, mastering listen) and session memory.MIT
- AlicenseBqualityBmaintenanceEnables Claude or any MCP client to produce full tracks in Ableton Live from chat: building tracks, writing MIDI notes, loading and tweaking device parameters, arranging sections, and drawing real clip and Arrangement automation. It also exposes mixer state snapshots and clip editing so a live set can be inspected and reshaped end to end.43MIT