Ableton Live MCP

Local MCP stdio server for inspecting and controlling Ableton Live through a local bridge.

Current package version: 0.2.1.

This repo does not assume a specific Ableton integration layer. The MCP server speaks JSON-RPC over stdio to an MCP client, then forwards tool calls to a local HTTP bridge that you can implement with Max for Live, Ableton's Extensions SDK, a Python Remote Script helper, or another Live automation layer.

Product Workflows

Start with docs/product-workflows.md for end-to-end setup, MIDI import, instrument assignment, arrangement, mixing, mastering, validation, and export workflows. The guide also documents safe operating rules for open user sets, destructive commands, explicit export approval, and unsupported bridge operations.

Tools

The exact tools/list response is capability-aware. It reads the active bridge's read-only GET /capabilities contract, hides hard-unsupported bridge actions, keeps MCP-local analysis/risk/workflow tools, and labels target-dependent tools Conditional. Clients should re-list tools after reconnecting or changing bridges. An unavailable or malformed handshake fails closed and does not advertise unverified Live writes.

Read and inspect:

ableton_get_status
ableton_get_project
ableton_get_arrangement
ableton_get_scene_tempo_signature_capabilities
ableton_list_plugins
ableton_search_browser
ableton_diagnose_plugins
ableton_get_production_report
ableton_diagnose_playback
ableton_get_meters
ableton_list_returns
ableton_list_buses
ableton_get_clip_notes
ableton_launch_clip
ableton_launch_scene
ableton_get_device_parameters
ableton_analyze_audio
ableton_analyze_mix
ableton_get_bridge_observability
ableton_evaluate_action_risk
ableton_list_risk_policy
ableton_match_preset_intent
ableton_list_workflow_plans
ableton_get_workflow_plan

Project, transport, track, and clip editing:

ableton_create_snapshot
ableton_rollback_snapshot
ableton_set_tempo
ableton_set_signature
ableton_set_scene_tempo_signature_overrides
ableton_start_transport
ableton_stop_transport
ableton_create_midi_track
ableton_duplicate_track
ableton_freeze_track
ableton_flatten_track
ableton_modify_track
ableton_create_midi_clip
ableton_consolidate_clip
ableton_delete_clip
ableton_humanize_clip
ableton_quantize_clip
ableton_apply_groove
ableton_import_midi

Devices, routing, returns, arrangement, mastering, and export:

ableton_load_device
ableton_load_master_device
ableton_select_vst_for_midi
ableton_set_device_parameter
ableton_reorder_device
ableton_delete_device
ableton_set_automation
ableton_create_return_track
ableton_modify_return
ableton_delete_return_track
ableton_modify_master
ableton_apply_mastering_chain
ableton_analyze_and_apply_mastering
ableton_export_render
ableton_bounce_tracks
ableton_insert_arrangement_clip
ableton_add_locator

Production Workflow

For meaningful LLM control, the recommended sequence is:

ableton_get_status, ableton_get_project, ableton_get_arrangement, and ableton_get_production_report to inspect transport, tracks, devices, clips, locators, routing, meters, returns, and mixer state.
ableton_create_snapshot before broad edits. For real user sets, also save or duplicate the .als file before destructive, export, or mastering work.
ableton_list_plugins and ableton_search_browser so the LLM can choose available instruments, effects, presets, samples, racks, grooves, plugins, and Max devices. Use ableton_match_preset_intent first when the request is musical, such as realistic violin, concert piano, classical guitar, flute, or concert hall mastering.
ableton_import_midi, ableton_create_midi_clip, or both.
ableton_humanize_clip, ableton_quantize_clip, or ableton_apply_groove for controlled MIDI timing edits.
ableton_select_vst_for_midi, ableton_load_device, or ableton_load_master_device to assign sounds and processing.
ableton_duplicate_track, ableton_consolidate_clip, ableton_insert_arrangement_clip, ableton_add_locator, ableton_modify_track, ableton_modify_return, ableton_modify_master, ableton_set_device_parameter, and ableton_set_automation for arrangement and mix moves.
ableton_freeze_track and ableton_flatten_track when committing tracks to audio is supported by the active bridge.
ableton_apply_mastering_chain for master bus preparation.
ableton_export_render, ableton_bounce_tracks, and ableton_analyze_audio, and ableton_analyze_mix for approved export, stem, and audio-validation workflows. File analysis runs locally in the MCP process and does not depend on Ableton's Remote Script meters.

Risk tiers and default blocking recommendations are documented in docs/risk-policy.md and exposed through ableton_evaluate_action_risk and ableton_list_risk_policy. High-level plan-only workflows are exposed through ableton_list_workflow_plans and ableton_get_workflow_plan. Render/export support is documented in docs/render-export-plan.md; the current Python Remote Script bridge returns explicit 501 unsupported responses for render-backed routes instead of simulating Live renders.

Quick Start

From npm:

npx -y @jterrats/ableton-live-mcp --help

Install the bundled Ableton Remote Script:

npx -y @jterrats/ableton-live-mcp install-remote-script --app-path "/Applications/Ableton Live 12 Lite.app"

Then restart Ableton Live, select AbletonMcpBridge in Preferences -> Link, Tempo & MIDI, and verify the installation:

npx -y @jterrats/ableton-live-mcp doctor --app-path "/Applications/Ableton Live 12 Lite.app"

Run the MCP stdio server:

npx -y @jterrats/ableton-live-mcp

Local development from this repo:

npm run smoke

Run the server:

npm start

Run the deterministic local development bridge:

npm run bridge

For dry-run development without Ableton:

ABLETON_MCP_DRY_RUN=1 npm start

MCP Client Config

Use this shape in an MCP client that supports stdio servers:

{
  "mcpServers": {
    "ableton-live": {
      "command": "npx",
      "args": ["-y", "@jterrats/ableton-live-mcp"],
      "env": {
        "ABLETON_BRIDGE_URL": "http://127.0.0.1:9789"
      }
    }
  }
}

Set ABLETON_MCP_DRY_RUN=1 in env when you want the tools to return the intended bridge calls without touching Ableton.

Bridge

The local bridge must listen on ABLETON_BRIDGE_URL and implement the HTTP contract in docs/ableton-bridge-contract.md.

This repo includes a deterministic development bridge for local MCP integration tests. It listens on 127.0.0.1:9789 by default, or on ABLETON_BRIDGE_PORT when configured, and implements the product workflow surface without requiring Ableton Live.

For the real Ableton Live adapter, install the Python Remote Script documented in docs/ableton-python-remote-script.md. That script runs inside Ableton and exposes the same bridge endpoints on 127.0.0.1:9789.

On this machine Ableton Live Lite and Suite were detected. Install the bundled Remote Script into the edition you actually launch, for example Suite:

npx -y @jterrats/ableton-live-mcp install-remote-script --app-path "/Applications/Ableton Live 12 Suite.app"

If macOS rejects writes to /Applications with Operation not permitted, close Ableton and retry with sudo -E npx -y @jterrats/ableton-live-mcp install-remote-script --app-path "/Applications/Ableton Live 12 Suite.app". If sudo is still blocked, grant App Management or Full Disk Access to your terminal app in System Settings -> Privacy & Security, then rerun the installer. Finder manual copy with authentication is also valid.

Release readiness checks are documented in docs/release-checklist.md.

Edition detection, Lite/Intro capacity guards, and Standard/Suite behavior are documented in docs/ableton-editions.md.

Keep the bridge local-only. Do not bind it to a public network interface unless you add authentication and understand the risk of remote DAW control.