AbletonMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| set_dataset_consentA | Record the user's answer to the dataset consent question. Call this ONLY after the user has answered in their own words. Never infer the answer, never call it on their behalf, and never call it because contributing seems helpful — consent the user did not give is not consent. If they have not been asked yet, ask first and wait for their reply. Parameters:
|
| get_session_infoB | Get detailed information about the current Ableton session Parameters:
|
| get_remote_script_infoA | Report Ableton Remote Script version and capabilities (handshake). Use this to verify the Live-side bridge matches this MCP server package. |
| get_track_infoC | Get detailed information about a specific track in Ableton. Parameters:
|
| get_clip_notesA | Read all MIDI notes from a Session-view clip. Returns pitch, start_time, duration, velocity, mute (and extended fields when available). Parameters:
|
| get_device_parametersB | Read all parameters for a device on a track (name, value, min, max). Parameters:
|
| set_device_parameterA | Set a device parameter to a specific value. Use get_device_parameters first to discover parameter indices and ranges. Parameters:
|
| get_session_snapshotA | Capture a full project state snapshot for trajectory recording. Includes session metadata, every track (mixer, devices, session clips, arrangement clips), optional MIDI notes, and optional device parameters. Used to version musical state S_t → S_{t+1}. Parameters:
|
| create_midi_trackA | Create a new MIDI track in the Ableton session. Parameters:
|
| create_audio_trackA | Create a new audio track in the Ableton session. Use this for recorded or imported audio (samples, stems, vocals). For MIDI instruments use create_midi_track instead. Parameters:
|
| get_tracks_overviewA | Compact overview of every track, return track and the master: index, name, color (#RRGGBB), whether it is a group, which group it belongs to, output routing, volume (dB text), pan, mute and solo. Use this before organizing a session; it is much cheaper than calling get_track_info per track. Parameters:
|
| set_track_colorA | Set a track's color. Live snaps it to the nearest color of its palette. Parameters:
|
| set_track_volumeA | Set a track's fader. Prefer volume_db (e.g. -6.0); volume is the raw normalized fader value 0.0-1.0 (0.85 is 0 dB in Live). Parameters:
|
| set_track_panA | Set a track's pan: -1.0 hard left, 0.0 center, 1.0 hard right. Parameters:
|
| set_track_muteA | Mute (True) or unmute (False) a track. Parameters:
|
| set_track_soloB | Solo (True) or unsolo (False) a track. Parameters:
|
| get_track_output_routingB | Show where a track's audio goes and every destination it can be routed to (e.g. 'Main', 'Group', other track names, 'Sends Only'). Parameters:
|
| set_track_output_routingA | Route a track's output to another destination by its display name, e.g. 'Main', a bus track's name, or 'Group'. Exact match first, then a unique partial match. On failure the error lists the valid options. Parameters:
|
| configure_tracksA | Apply many track changes in ONE call (much faster and cheaper than one call per setting). Each item is a dict with track_index and any of: track_type ('track'|'return'|'master'), name, color, volume_db, volume, pan, mute, solo, output (routing destination name). Example: [{"track_index": 0, "name": "Kick", "color": "red", "output": "DRUMS BUS", "volume_db": -6}] Items are applied in order; a failing item does not stop the rest. Parameters:
|
| set_track_nameA | Set the name of a track. Parameters:
|
| create_clipB | Create a new MIDI clip in the specified track and clip slot. Parameters:
|
| create_audio_clipA | Create a new audio clip in an audio track's clip slot by importing a file. Requires Ableton Live 12.0.5 or newer — the underlying ClipSlot.create_audio_clip Live API was introduced in 12.0.5 and is not available in earlier 12.0.x releases. Parameters:
|
| add_notes_to_clipB | Add MIDI notes to a clip. Parameters:
|
| clear_notes_from_clipA | Remove all MIDI notes from a Session clip. Writes are additive (add_notes_to_clip only appends), so to truly modify a clip you clear it first, then add the new notes. Use this with get_clip_notes and add_notes_to_clip for a real read -> modify -> write loop: read the notes, edit the list, clear_notes_from_clip, then add_notes_to_clip the edited notes. Parameters:
|
| set_clip_nameC | Set the name of a clip. Parameters:
|
| set_arrangement_clip_nameA | Set the name of a clip placed in the Arrangement timeline. Parameters:
|
| set_tempoB | Set the tempo of the Ableton session. Parameters:
|
| load_instrument_or_effectB | Load an instrument or effect onto a track using its URI. Parameters:
|
| fire_clipB | Start playing a clip. Parameters:
|
| stop_clipA | Stop playing a clip. Parameters:
|
| delete_clipA | Delete the clip in the given clip slot, freeing it for reuse. Use this before create_clip when you want to overwrite an existing clip (create_clip itself refuses to write into an occupied slot). Parameters:
|
| start_playbackB | Start playing the Ableton session. Parameters:
|
| stop_playbackB | Stop playing the Ableton session. Parameters:
|
| get_browser_treeC | Get a hierarchical tree of browser categories from Ableton. Parameters:
|
| get_browser_items_at_pathA | Get browser items at a specific path in Ableton's browser. Parameters:
|
| load_drum_kitB | Load a drum rack and then load a specific drum kit into it. Parameters:
|
| switch_to_arrangement_viewC | Switch Ableton's main window to the Arrangement view. Parameters:
|
| set_arrangement_timeA | Move the arrangement playhead to a specific position. Parameters:
|
| get_arrangement_clipsA | List all clips placed in the Arrangement timeline for a track. Returns each clip's name, start_time, end_time, length, and type. Parameters:
|
| duplicate_to_arrangementA | Copy a Session-view clip into the Arrangement timeline. Uses Live's track.duplicate_clip_to_arrangement() API (Live 11 / 12). The clip is placed at destination_time beats from the start of the arrangement on the same track it lives in. Typical workflow:
Parameters:
|
| create_locatorA | Create a named locator (cue point) in the Arrangement at a beat position. If a locator already exists at that beat (within ~1e-3 tolerance) it is renamed instead of toggled off. Time is in beats from the start of the arrangement (e.g. 0.0 = start, 16.0 = bar 5 in 4/4). Parameters:
|
| submit_intentA | Record the human's creative intent for subsequent actions in this session. Call this before a sequence of edits so trajectory steps are conditioned on intent. Levels: 1=atomic, 2=musical op, 3=section, 4=song, 5=creative goal. Requires telemetry consent. Data is stored in Supabase (same project as telemetry). Parameters:
|
| rate_last_actionA | Rate the most recent recorded action (or the track after an edit). Ratings: better | same | worse | keep | reject | thumbs_up | thumbs_down Optional tags (comma-separated): groove, harmony, melody, sound, arrangement, energy, mix, emotion Requires telemetry consent. Parameters:
|
| prefer_candidateA | Record a pairwise preference between two candidate actions or auditions. winner should be 'a', 'b', or an explicit candidate id matching A or B. Requires telemetry consent. Parameters:
|
| reject_last_actionA | Mark the last action as rejected (exploration / preference boundary). Use when the human undoes or discards an agent edit. Requires telemetry consent. Parameters:
|
| record_auditionA | Log a browser/preset/sample audition (keep or reject) for preference learning. Call once per candidate auditioned. Does not load the device — use load_instrument_or_effect when kept=True and you want to commit. Requires telemetry consent. Parameters:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 46 tools
Most tools map cleanly to a distinct resource+action (create_midi_track vs create_audio_track, set_clip_name vs set_arrangement_clip_name) and descriptions explicitly disambiguate. The main soft spots are four overlapping read tools (get_session_info, get_session_snapshot, get_tracks_overview, get_track_info), the per-setting set_track_* calls versus the bulk configure_tracks, and fire_clip versus start_playback.
Nearly everything is snake_case with a verb-first pattern (get_*, set_*, create_*, load_*, stop_*, record_*). A few read as noun-first or awkward (fire_clip, switch_to_arrangement_view) and the telemetry tools use a slightly different imperative vocabulary, but the convention is readable and predictable overall.
46 tools is heavy even for a DAW bridge. The six individual track setters (name, color, volume, pan, mute, solo) are all subsumed by configure_tracks, and six further tools are telemetry/preference logging (submit_intent, rate_last_action, prefer_candidate, reject_last_action, record_audition, set_dataset_consent) that sit outside the musical editing surface.
Core workflows are well covered: session reading, track creation, clip lifecycle, notes read/modify/write, device loading and parameters, browser browsing, transport, tempo, arrangement and locators. Notable gaps remain — no delete_track, no return/group track creation, no device or parameter reset/removal, no send-level control, and no way to list a track's devices.