Local-first Ableton Live control for MCP clients. It has three parts: a Remote Script bridge that runs inside Live, a stdio MCP server, and an ableton-mcp CLI. Every change to the Live Set is planned first and runs only with a single-use confirmation.
An AI production assistant for Ableton Live: develop musical ideas, edit MIDI, refine sounds and arrange tracks in an editable Live Set.
Stars
4
Tools
—
Uptime
—
Install
Requirements: macOS, Ableton Live 12 (tested with 12.4.6), Node.js 22.13 or newer, and ffmpeg for the audio analysis tools.
git clone https://github.com/cavi-ai/ableton-mcp.git
cd ableton-mcp
npm ci
npm run cli -- install
In Live's preferences, select CaviMcpBridge as a Control Surface. Then check the connection:
npm run cli -- doctor --json
Quickstart
Register the stdio server with your MCP client, using the absolute path of your checkout:
npm run cli -- status --json
npm run cli -- call list_devices --args '{"trackId":"track-0"}' --json
Find workflow guidance before choosing individual tools:
npm run cli -- call get_producer_workflow --args '{"query":"silent part","limit":3}' --json
Search returns keyword candidates with their required arguments. Retrieve a chosen reference by its exact workflow name and named string arguments. Searching and reading guidance do not execute Live operations.
To try client wiring without Live, run ABLETON_MCP_FIXTURE=1 npm start.
For a smaller initial tool catalog, set ABLETON_MCP_TOOL_PROFILE=core in the MCP server's environment. It advertises 63 common tools instead of the full catalog. Use the default all profile when an agent needs the complete MIDI, audio, rack, or snapshot toolset; restart the server after changing profiles. The CLI's direct call command remains independent of the discovery profile.
What it does
For separate creative and functional model contexts, configure optional production specialists. ABLETON_MCP_TOOL_PROFILE=producer exposes twelve tools, with detailed context and durable session history stored in private artifacts. Each role can use an installed Ollama model, a configured ACP agent or an explicitly enabled API client for Claude, Codex, OpenClaw, Hermes, OpenCode or AGY; Live changes retain their existing confirmation guards.
Reads: transport, tempo, key and scale, quantization, grooves, cue points, tracks, scenes, clips, notes, clip envelopes, devices and parameters, mixer and routing, rack hierarchies, and the Live browser.
Guarded mutations: track, scene and clip lifecycle, device loading and parameters, MIDI note editing, mixing and routing, undo and redo, and panic.
Music helpers: scale-aware chords, basslines, melodies, voicings, arpeggios, strums, drum patterns, humanization and velocity curves.
Audio analysis: loudness, true peak, spectrum, pitch, transients and tuning of local audio files.
Optional NKS preset catalog: search, tags and favorites for presets discovered from your plug-in libraries.
It publishes 328 tools, 9 concrete resources, 13 resource templates and 89 prompt templates. When Live's Remote Script API doesn't expose something, such as Arrangement automation, the tool reports that boundary and fails closed.
Bridge socket. Read by both the bridge inside Live and the server.
ABLETON_MCP_CATALOG_PATH
unset
NKS catalog database for preset search.
ABLETON_MCP_BROWSER_METADATA_PATH
~/.cavi/ableton-mcp/browser-metadata.sqlite
Tags and favorites for Live browser items.
ABLETON_MCP_SPLICE_ROOTS
Existing macOS ~/Splice/Sounds and ~/Library/Splice/Plug-in/samples directories; otherwise []
Override with a JSON array of absolute local Splice folders. Set [] to disable discovery. Local cache files are not proof of a download license; cloud search and sync are not supported.
ABLETON_MCP_CONFIRMATION_DIR
~/.cavi/ableton-mcp/confirmations
Confirmation tokens for CLI call.
ABLETON_MCP_SNAPSHOT_DIR
~/.cavi/ableton-mcp/snapshots
Saved track, device-chain, group-system, and MIDI-feel snapshots in separate subdirectories.
ABLETON_MCP_FIXTURE
unset
1 makes npm start serve fixture data without Live.
ABLETON_MCP_TOOL_PROFILE
all
core: 63 common tools; producer: 12 specialist/session tools; directory: named native tools without coordinators; all: every tool. Compact profiles retain full runtime result validation.
Security
The bridge listens on a Unix domain socket and opens no TCP port. Live Set mutations require an observed state version, return a dry-run plan by default, and execute only with a 60-second, single-use token bound to the plan's hash. See the security model and SECURITY.md.
Tests
npm test
npm run eval:core
npm run verify:package
npm test runs the pipeline and server suites, the bridge's Python tests, and the docs tests. eval:core checks the compact MCP catalog and read-only tool behavior with MCP Eval. ImageMagick 7 (magick) and ffmpeg must be installed. verify:package packs the npm tarball, installs it into a temporary project, and drives the installed CLI and server.
Readiness scoring also requires a running Live bridge, a configured preset catalog, and available MIDI clips, audio sources, and devices. The manifest gate and readiness score are reported separately.
For model-driven mixer, MIDI, device and reconnect/resume checks against a saved scratch Set, see workflow validation.
Project status
See GitHub Releases and the changelog for released versions and changes. The tool surface can still change before 1.0.
The code and the generic example artwork are MIT licensed. Third-party product names belong to their owners. No vendor artwork, logos or presets are included, and no endorsement is implied.
A
Ableton
cavi-ai·4 stars·
An AI production assistant for Ableton Live: develop musical ideas, edit MIDI, refine sounds and arrange tracks in an editable Live Set.
No tool list yet. Remote servers get one after the first health check.
FAQ
Questions
How do I install Ableton?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Ableton need an API key?
No required environment variable is listed on this record.
What transport does Ableton use?
Ableton runs locally over stdio.
When was Ableton last checked?
Last checked 2026-11-18. An AI production assistant for Ableton Live: develop musical ideas, edit MIDI, refine sounds and arrange tracks in an editable Live Set.