Skip to main content
Glama
Ableton MCP Extended

Ableton MCP Extended

by zabolotniydj

Ableton MCP Extended

ClaudeやCursorなどのAIアシスタントを使って、自然言語でAbleton Liveを操作できます。このプロジェクトは、自然言語のコマンドをAbleton Liveセッション内の正確なアクションに変換する、堅牢なModel Context Protocol (MCP) サーバーを提供します。

改良版フォーク。 Remote Scriptコマンド22個とMCPツール25個を追加: MIDIノートの読み取り、シーン、セッションクリップのプロパティ、ミキサー(mute/solo/arm、センド)、 Wavetableのモジュレーションマトリックス、undo/redo。 詳細とインストール方法は FORK-NOTES.md を参照してください。

License: MIT Python 3.10+ Ableton Live 11+


ビデオデモ: https://www.youtube.com/watch?v=7ZKPIrJuuKk

このツールは、音楽制作ワークフローを効率化し、生成音楽を実験し、Ableton Liveとのカスタム統合を構築したいと考えているプロデューサー、開発者、AI愛好家のために設計されています。

この会話を:

👤 "Create a brief minimalist/neo-classical composition in a style similar to Ólafur Arnalds'. (Ableton MCP) / I've loaded four MIDI tracks called "Noire" and "Noire (2) ["Emotional Felt" presets], "Noire (2) ["Reversed Felt" preset, for ambient background], and "Noire (3) ["Ethereal Felt" preset, also for ambient background]. All loaded with nice piano instruments. You have also a MIDI track called "Strings" with a nice string ensemble instrument loaded. Feel free to add new instruments and effects, if pertinent."
🤖 "Creating MIDI clips... Adding effects... Done!"
👤 "Then, use ElevenLabs MCP to create a spoken-word audio clip (default voice and settings) with a relevant poem in the style of “Jim Morrison” to accompany the composition."  
🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"

この音楽制作セッションに変換できます:

https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3


主な機能

このプロジェクトは、Ableton Live環境に対する包括的かつプログラム的な制御を提供します。

  • セッションとトランスポートの制御:

    • 再生の開始と停止。

    • テンポ、拍子記号、トラック数を含むセッション情報の取得。

    • シーンの管理: 作成、削除、名前変更、起動。

  • トラック管理:

    • MIDIトラックとオーディオトラックの作成、名前変更、詳細情報の取得。

    • トラックプロパティの制御: ボリューム、パン、ミュート、ソロ、アーム。

    • トラックのグループ化と折りたたみ状態の管理。

  • MIDIクリップとノートの操作:

    • 指定した長さのMIDIクリップの作成と命名。

    • クリップ内のノートの追加、削除、移調、クオンタイズ。

    • 単一操作での複数ノートの一括編集。

    • クリップのループパラメータとフォローアクションの調整。

  • デバイスとパラメータの制御:

    • AbletonのブラウザからURIでインストゥルメントとエフェクトをロード。

    • トラック上の任意のデバイスの全パラメータリストを取得。

    • 正規化された値(0.0〜1.0)を使用してデバイスパラメータを設定および一括設定。

  • オートメーションとエンベロープ:

    • クリップ内の任意のデバイスパラメータにオートメーションポイントを追加およびクリア。[この機能はまだ完全には動作していません。]

    • 既存のクリップエンベロープに関する情報を取得。

  • ブラウザ統合:

    • Abletonのブラウザ内の項目をナビゲートおよび一覧表示。

    • ブラウザのパスまたはURIからインストゥルメント、エフェクト、サンプルを直接ロード。

    • オーディオファイルをオーディオトラックまたはクリップスロットに直接インポート。

  • 音声&オーディオ生成

    • テキスト読み上げ統合: ElevenLabs MCP [同梱] によるナレーション、ボーカルサンプル、音声要素の生成。

    • カスタムボイス作成: トラックにユニークなキャラクターを与えるためのボイスクローン。

    • サウンドエフェクト: AIによるカスタムSFXの作成。

    • 直接インポート: 生成されたオーディオがAbletonセッションに即座に表示されます。

  • カスタムツールのための拡張可能なフレームワーク

    • 例: XYマウスコントローラー: MCPフレームワークでカスタムAbletonコントローラーを作成するデモ。

    • 超低レイテンシー: 高性能UDPプロトコルにより、レスポンシブなリアルタイム制御を実現。

    • 無限の可能性: Ableton Live用の独自のカスタムツールとコントローラーを構築。


Related MCP server: io.github.peterkolbe/ableton-for-ai

クイックスタート(5分)

前提条件

  • Ableton Live 11以降(全エディション)

  • Python 3.10以上

  • Claude DesktopまたはCursor IDE

1. コードを取得

git clone https://github.com/uisato/ableton-mcp-extended.git
cd ableton-mcp-extended
pip install -e .

2. Abletonスクリプトをインストール

  1. AbletonのUser Library Remote Scriptsフォルダを見つけます:

    • Windows: C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\

    • Mac: ~/Music/Ableton/User Library/Remote Scripts/

  2. フォルダを作成: AbletonMCP

  3. AbletonMCP_Remote_Script/__init__.py をこのフォルダにコピー

3. Abletonを設定

  1. Ableton Liveを開く

  2. Preferences → Link, Tempo & MIDI に移動

  3. Control Surface を "AbletonMCP" に設定

  4. Input/Output を "None" に設定

4. AIアシスタントを接続

Claude Desktopの場合:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
    }
  }
}

Cursorの場合: Settings → MCP で同じパスを使用してMCPサーバーを追加。

5. 作成を開始!

AIアシスタントを開いて試してみてください:

  • "ピアノ付きの新しいMIDIトラックを作成"

  • "シンプルなドラムビートを追加"

  • "現在どのトラックがありますか?"


仕組み

graph TB
    A[You: Natural Language] --> B[AI Assistant]
    B --> C[MCP Server]
    C --> D[Ableton Remote Script]
    D --> E[Ableton Live API]
    E --> F[🎵 Your Music]
    
    G[ElevenLabs AI] --> H[Generated Audio]
    H --> C
  1. プレーンな英語でAIアシスタントにコマンドを発行します(例: "Create a new MIDI track and name it 'Bass'")。

  2. AIアシスタントが意図を理解し、MCPサーバーから適切なツールを呼び出します。

  3. MCPサーバー(server.py)がツール呼び出しを受信し、特定のJSONコマンドを構築します。

  4. Live内で実行されているAbleton Remote Script(init.py)が、ソケット接続を介してJSONコマンドを受信します。

  5. Remote Scriptが公式のAbleton Live APIを使用してコマンドを実行し、セッションに即座に変更を加えます。


高度な機能

超低レイテンシーでのリアルタイムパラメータ制御:

# Install the hybrid server
cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/

# Try the XY Mouse Controller example
cd experimental_tools/xy_mouse_controller
python mouse_parameter_controller_udp.py

これは以下の構築方法を示しています:

  • Ableton用のカスタムリアルタイムコントローラー

  • 表現力豊かなパフォーマンスツール

  • インタラクティブな音楽アプリケーション

このリポジトリは、ElevenLabs用のMCPサーバーなど、他のMCPサーバーと統合して、オーディオを生成してプロジェクトに直接インポートできます。

ElevenLabs MCPサーバーをその指示に従ってセットアップします。

両方のサーバーを含めるようにAIアシスタントの設定を更新します。

mcp-config.jsonの例:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["/path/to/ableton-mcp-extended/server.py"]
    },
    "ElevenLabs": {
      "command": "python",
      "args": ["/path/to/elevenlabs_mcp/server.py"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

コンポーネント概要

このプロジェクトには、いくつかの専門コンポーネントが含まれています:

コアMCPサーバー

  • 信頼性の高いAI制御のための標準TCP通信

  • 包括的なAbleton Live API統合

  • Claude Desktop、Cursor、Gemini CLIと互換性あり。

ハイブリッドTCP/UDPサーバー

  • 高性能なリアルタイムパラメータ制御

  • ライブパフォーマンスのための超低レイテンシー

  • コントローラーとインタラクティブツールに最適

ElevenLabs統合

  • プロフェッショナルなテキスト読み上げ生成

  • カスタムボイスの作成とクローン

  • Abletonセッションへの直接インポート

  • リアルタイムSFX生成

実験的ツールと例

  • XYマウスコントローラー: カスタムAbletonコントローラーの構築方法を示す例

  • 拡張可能なフレームワーク: 独自のコントロールインターフェースを作成するための基盤

  • 概念実証: MCPアプローチのパワーと柔軟性を示します


ドキュメント


コミュニティ&サポート

  • GitHub Issues: バグ報告と機能リクエスト

  • Discussions: 作品の共有とサポート

作品を共有

AI生成の実験結果をタグ付けしてください!コミュニティの作品を見るのが大好きです:

YouTube | Instagram | Patreon | Website


今後の予定

  • オートメーションポイント配置バグの修正

  • VSTプラグインサポート - サードパーティプラグインの制御 [「Configure」パラメータ機能で実現可能] → 完了!

  • アレンジメントビュー - 完全なタイムライン制御

  • ハードウェア統合 - AIを介したMIDIコントローラーのブリッジ

  • 高度なAI - よりスマートで優れた音楽理解と生成


ライセンスとクレジット

このプロジェクトはMITライセンスの下でライセンスされています - 詳細は LICENSE を参照してください。

使用技術:

インスピレーション: 元の ableton-mcp プロジェクト


音楽制作コミュニティのために❤️を込めて作られました

このプロジェクトがあなたの創造性に役立つなら、⭐スターを付けてください!

Available Tools

71 tools
add_notes_to_clipB

Add MIDI notes to a clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

  • notes: List of note dictionaries, each with pitch, start_time, duration, velocity, and mute.

Inputs: notes (required), clip_index (required), track_index (required). Returns: result

add_wavetable_mod_targetB

Make a parameter a modulation target in Wavetable's matrix.

Reports which device parameters appeared as a result, which shows whether the matrix amounts become ordinary automatable parameters.

Parameters:

  • track_index: Track number (1-based).

  • parameter_name: Target parameter name (or use parameter_index).

  • parameter_index: Target parameter number (1-based).

  • device_index: Device number on the track (1-based).

  • chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Inputs: track_index (required), chain_index, device_index, parameter_name, +1 more. Returns: result

clear_notes_from_clipA

Remove every MIDI note from a Session clip, leaving the clip in place.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

Inputs: clip_index (required), track_index (required). Returns: result

control_arrangement_viewA

Control the arrangement view.

Parameters:

  • action: One of: zoom_in, zoom_out, scroll_left, scroll_right, follow_on, follow_off, collapse_track, expand_track.

  • track_index: Track number (1-based, for collapse/expand).

Inputs: action (required), track_index. Returns: result

create_arrangement_audio_clipA

Place an audio file as a clip in the arrangement.

Parameters:

  • track_index: Track number (1-based).

  • file_path: Path to the audio file.

  • start_bar: Start bar (1-based).

  • start_beat: Start position in beats.

Inputs: file_path (required), track_index (required), start_bar, start_beat. Returns: result

create_arrangement_midi_clipB

Create an empty MIDI clip in the arrangement.

Parameters:

  • track_index: Track number (1-based).

  • start_bar: Start bar (1-based). Takes precedence over start_beat.

  • end_bar: End bar (1-based). Used with start_bar to compute length.

  • start_beat: Start position in beats.

  • length_beats: Clip length in beats.

  • name: Optional clip name.

Inputs: track_index (required), name, end_bar, start_bar, +2 more. Returns: result

create_audio_trackB

Create a new audio track.

Parameters:

  • index: Insert position (-1 = end of list).

Inputs: index. Returns: result

create_clipB

Create a new MIDI clip in the specified track and clip slot.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

  • length: The length of the clip in beats (default: 4.0).

Inputs: clip_index (required), track_index (required), length. Returns: result

create_cue_pointA

Create a cue point at a position.

Parameters:

  • bar: Bar number (1-based).

  • beat: Beat position (0-based).

  • name: Name for the cue point.

Inputs: bar, beat, name. Returns: result

create_midi_trackA

Create a new MIDI track in the Ableton session.

Parameters:

  • index: The index to insert the track at (-1 = end of list)

Inputs: index. Returns: result

create_sceneA

Insert a new scene.

Parameters:

  • index: Position (1-based), or -1 to append at the end.

Inputs: index. Returns: result

delete_arrangement_clipC

Delete an arrangement clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip position in arrangement (1-based).

  • clip_name: Clip name (alternative to clip_index).

Inputs: track_index (required), clip_name, clip_index. Returns: result

delete_clipA

Delete the clip in a Session slot, freeing the slot.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

Inputs: clip_index (required), track_index (required). Returns: result

delete_cue_pointA

Delete a cue point at a position.

Parameters:

  • bar: Bar number (1-based).

  • beat: Beat position (0-based).

Inputs: bar, beat. Returns: result

delete_deviceB

Delete a device from a track.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number (1-based).

  • device_name: Device name (alternative to device_index).

Inputs: track_index (required), device_name, device_index. Returns: result

delete_sceneB

Delete a scene and everything in that row.

Parameters:

  • scene_index: Scene number (1-based).

Inputs: scene_index (required). Returns: result

delete_trackA

Delete a track from the Ableton session.

Parameters:

  • track_index: Track number (1-based). Use 0 to resolve by name instead.

  • track_name: Track name (alternative to track_index). If both are given, track_index takes priority.

Inputs: track_name, track_index. Returns: result

describe_device_apiA

Report what a device object actually exposes in the running build of Live.

Device-specific classes (WavetableDevice, SimplerDevice, ...) carry members that never appear in the parameter list. Use this to find them.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number on the track (1-based).

  • chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Inputs: track_index (required), chain_index, device_index. Returns: result

disable_deviceA

Disable (bypass) a device on a track.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number (1-based). Use 0 if using device_name.

  • device_name: Device name (alternative to device_index).

  • chain_index: Chain number inside a rack (1-based, 0 = no chain).

Inputs: track_index (required), chain_index, device_name, device_index. Returns: result

duplicate_clip_to_arrangementC

Copy a session clip to the arrangement.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Session clip slot (1-based).

  • destination_bar: Destination bar (1-based).

  • destination_beat: Destination beat.

Inputs: clip_index (required), track_index (required), destination_bar, destination_beat. Returns: result

duplicate_sceneA

Duplicate a scene, inserting the copy directly below it.

Parameters:

  • scene_index: Scene number (1-based).

Inputs: scene_index (required). Returns: result

enable_deviceA

Enable (activate) a device on a track.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number (1-based). Use 0 if using device_name.

  • device_name: Device name (alternative to device_index).

  • chain_index: Chain number inside a rack (1-based, 0 = no chain).

Inputs: track_index (required), chain_index, device_name, device_index. Returns: result

fire_clipB

Start playing a clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

Inputs: clip_index (required), track_index (required). Returns: result

fire_sceneA

Launch a scene: every clip in that row starts, and tracks whose slot in the row is empty are stopped.

Parameters:

  • scene_index: Scene number (1-based).

Inputs: scene_index (required). Returns: result

get_arrangement_infoA

Get arrangement clips and transport state.

Parameters:

  • track_index: Track number (1-based). 0 = all tracks.

Inputs: track_index. Returns: result

get_browser_items_at_pathA

Get browser items at a specific path in Ableton's browser.

Parameters:

  • path: Path in the format "category/folder/subfolder" where category is one of the available browser categories in Ableton

Inputs: path (required). Returns: result

get_browser_treeC

Get a hierarchical tree of browser categories from Ableton.

Parameters:

  • category_type: Type of categories to get ('all', 'instruments', 'sounds', 'drums', 'audio_effects', 'midi_effects')

Inputs: category_type. Returns: result

get_chain_infoA

List chains in a rack device, or devices within a specific chain.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number (1-based, default 1).

  • chain_index: Chain number (1-based) to drill into. 0 = list all chains.

Inputs: track_index (required), chain_index, device_index. Returns: result

get_clip_notesA

Read the MIDI notes of a Session clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

Inputs: clip_index (required), track_index (required). Returns: result

get_clip_propertiesA

Read a Session clip's Clip-panel properties.

Covers Transpose, Clip Gain, Loop Position/Length, Start/End, warping and whether the clip is deactivated. Audio-only properties are omitted for MIDI clips rather than failing.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

Inputs: clip_index (required), track_index (required). Returns: result

get_cue_pointsA

List all cue points (locators) with bar positions.

Inputs: no named parameters. Returns: result

get_device_parametersA

List parameters for a device on a track.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number on the track (1-based, default 1).

  • chain_index: Chain number inside a rack (1-based, 0 = no chain).

  • category: Filter by category name (returns detail for that category).

  • show_all: If True, return all parameters in detail mode.

Default mode returns a summary grouped by category with counts. Specify category or show_all=True for full parameter details.

Inputs: track_index (required), category, show_all, chain_index, +1 more. Returns: result

get_drum_pad_infoA

List filled drum pads in a Drum Rack.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number (1-based, default 1).

Inputs: track_index (required), device_index. Returns: result

get_scenesA

List every scene with its name, state and which clips it holds.

A scene is a row of the Session grid. Use this to see which clips would launch together.

Inputs: no named parameters. Returns: result

get_session_infoA

Get detailed information about the current Ableton session

Inputs: no named parameters. Returns: result

get_session_snapshotA

Dump the whole project state in one call: tracks, clips, devices, scenes, returns, master and cue points.

Parameters:

  • include_notes: Include MIDI notes of every clip (large output).

  • include_params: Include every device parameter (very large output).

Inputs: include_notes, include_params. Returns: result

get_track_deletion_statusA

Check whether session tracks can be deleted right now.

Returns a quick safety summary so agents can avoid attempting deletes when Ableton's minimum-track constraint would block them.

Inputs: no named parameters. Returns: result

get_track_infoC

Get detailed information about a specific track in Ableton.

Parameters:

  • track_index: Track number (1-based).

Inputs: track_index (required). Returns: result

get_track_volumeA

Get the current fader volume and panning for a track.

Returns the raw normalized value, its min/max range, and the panning. Volume 0.85 = 0 dB unity gain. Use this before set_track_volume to understand the current state.

Parameters:

  • track_index: Track number (1-based). Return tracks come after session tracks.

Inputs: track_index (required). Returns: result

get_wavetable_stateA

Read a Wavetable's modulation matrix, wavetable selection and voicing.

None of this appears in get_device_parameters - it lives on the WavetableDevice object itself.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number on the track (1-based).

  • chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Inputs: track_index (required), chain_index, device_index. Returns: result

jump_to_cue_pointC

Jump to a cue point.

Parameters:

  • direction: "next" or "prev"

  • name: Cue point name to jump to.

Inputs: name, direction. Returns: result

list_external_pluginsA

List discovered external plugins (VST/AU), optionally filtered by name query.

Parameters:

  • query: Optional case-insensitive search string.

  • max_results: Maximum number of plugins to display.

  • refresh_cache: If True, force a rescan instead of using cached results.

Inputs: query, max_results, refresh_cache. Returns: result

load_drum_kitA

Load a drum rack and then load a specific drum kit into it.

Parameters:

  • track_index: Track number (1-based).

  • rack_uri: The URI of the drum rack to load (e.g., 'Drums/Drum Rack').

  • kit_path: Path to the drum kit inside the browser (e.g., 'drums/acoustic/kit1').

Inputs: kit_path (required), rack_uri (required), track_index (required). Returns: result

load_external_pluginA

Load an external plugin onto a track by plugin name (no URI required).

Parameters:

  • track_index: Track number (1-based).

  • plugin_name: Plugin name to match (e.g., "FabFilter Pro-Q 3").

  • exact_match: If True, require exact normalized name match.

  • refresh_cache: If True, force a rescan before matching.

Inputs: plugin_name (required), track_index (required), exact_match, refresh_cache. Returns: result

load_instrument_or_effectA

Load an instrument or effect onto a track using its URI.

Parameters:

  • track_index: Track number (1-based).

  • uri: The URI of the instrument or effect to load (e.g., 'query:Synths#Instrument%20Rack:Bass:FileId_5116').

Inputs: uri (required), track_index (required). Returns: result

manage_clip_automationB

Create or clear automation envelopes on arrangement clips.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip position (1-based).

  • clip_name: Clip name (alternative to clip_index).

  • action: "create", "clear", or "clear_all".

  • parameter_name: Parameter to automate (e.g., "volume", "panning").

Inputs: track_index (required), action, clip_name, clip_index, +1 more. Returns: result

redoA

Redo the last undone action in Live.

Inputs: no named parameters. Returns: result

replace_notes_in_clipA

Replace a clip's contents: clear every existing note, then write these.

add_notes_to_clip only appends. This clears first, so the clip ends up with exactly the notes given.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

  • notes: Note dicts with pitch, start_time, duration, velocity, mute.

Inputs: notes (required), clip_index (required), track_index (required). Returns: result

set_ableton_viewA

Switch Ableton's main view.

Parameters:

  • view: View name. Options: Arranger, Session, Detail, Detail/Clip, Detail/DeviceChain, Browser.

Inputs: view. Returns: result

set_arrangement_clip_propertyA

Set properties on an arrangement clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip position (1-based).

  • clip_name: Clip name (alternative to clip_index).

  • name: New clip name.

  • muted: Mute state.

  • color: Color (0x00RRGGBB).

  • looping: Loop on/off.

  • loop_start: Loop start in beats.

  • loop_end: Loop end in beats.

  • gain: Audio gain (0.0-1.0).

  • pitch_coarse: Semitone pitch shift (-48 to 48).

  • pitch_fine: Fine pitch shift (-50 to 49 cents).

  • warping: Warp on/off.

  • warp_mode: Warp mode (0-6).

Inputs: track_index (required), gain, name, color, +10 more. Returns: result

set_arrangement_loopA

Enable/disable arrangement loop and set region.

Parameters:

  • enabled: Whether loop is on.

  • start_bar: Loop start (1-based). Takes precedence over start_beat.

  • end_bar: Loop end (1-based). Used with start_bar to compute length.

  • start_beat: Loop start in beats.

  • length_beats: Loop length in beats.

Inputs: enabled, end_bar, start_bar, start_beat, +1 more. Returns: result

set_clip_nameB

Set the name of a clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

  • name: The new name for the clip.

Inputs: name (required), clip_index (required), track_index (required). Returns: result

set_clip_propertyA

Set one property on a Session clip.

Writable names: name - clip name muted - True deactivates the clip (the "0" key in Live) color - clip colour as an integer pitch_coarse - Transpose in semitones pitch_fine - fine tune in cents looping - loop on/off loop_start / loop_end - Loop Position and end, in beats start_marker / end_marker - clip Start/End, in beats gain - Clip Gain (audio clips) warping - warp on/off (audio clips) warp_mode - warp algorithm (audio clips) velocity_amount - velocity-to-volume amount (MIDI clips)

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

  • property_name: One of the names above.

  • value: New value; type depends on the property.

Inputs: value (required), clip_index (required), track_index (required), property_name (required). Returns: result

set_device_parameterB

Set a device parameter value.

Parameters:

  • track_index: Track number (1-based).

  • device_index: Device number (1-based, default 1).

  • chain_index: Chain number inside a rack (1-based, 0 = no chain).

  • parameter_name: Parameter name, friendly alias, or partial match.

  • parameter_index: Parameter number (1-based, alternative to name).

  • value: Normalized value 0.0-1.0.

Inputs: track_index (required), value, chain_index, device_index, +2 more. Returns: result

set_scene_propertyA

Set a scene's name, colour, tempo or time signature.

Writable names: name, color, tempo, time_signature_numerator, time_signature_denominator.

Writing tempo or a time signature from the API also switches that scene control on, so no separate enable step is needed.

Parameters:

  • scene_index: Scene number (1-based).

  • property_name: One of the names above.

  • value: New value.

Inputs: value (required), scene_index (required), property_name (required). Returns: result

set_send_levelA

Set one send level from a track to a return track.

Parameters:

  • track_index: Track number (1-based).

  • send_index: Send slot (1-based; send 1 feeds return A, 2 feeds B, ...).

  • value: Normalized 0.0 (off) to 1.0 (max).

Inputs: value (required), send_index (required), track_index (required). Returns: result

set_song_timeA

Jump playback to a position.

Parameters:

  • bar: Bar number (1-based). Takes precedence over beat.

  • beat: Beat position (0-based).

Inputs: bar, beat. Returns: result

set_tempoA

Set the tempo of the Ableton session.

Parameters:

  • tempo: The new tempo in BPM

Inputs: tempo (required). Returns: result

set_track_armA

Arm or disarm a track for recording. Group and return tracks cannot be armed.

Parameters:

  • track_index: Track number (1-based).

  • arm: True to arm, False to disarm.

Inputs: arm (required), track_index (required). Returns: result

set_track_muteB

Mute or unmute a track.

Parameters:

  • track_index: Track number (1-based). Return tracks come after session tracks.

  • mute: True to mute, False to unmute.

Inputs: mute (required), track_index (required). Returns: result

set_track_nameC

Set the name of a track.

Parameters:

  • track_index: Track number (1-based).

  • name: The new name for the track.

Inputs: name (required), track_index (required). Returns: result

set_track_panningA

Set the mixer panning for a track.

Parameters:

  • track_index: Track number (1-based).

  • panning: -1.0 = full left, 0.0 = center, +1.0 = full right.

Inputs: panning (required), track_index (required). Returns: result

set_track_soloA

Solo or unsolo a track.

Parameters:

  • track_index: Track number (1-based).

  • solo: True to solo, False to clear.

Inputs: solo (required), track_index (required). Returns: result

set_track_volumeA

Set the mixer fader volume for a track directly.

This controls the actual track fader, not any device parameter.

Volume scale (normalized): 0.0 = silence 0.85 = 0 dB (unity gain, Ableton's default fader position) 1.0 = maximum (~+6 dB)

Parameters:

  • track_index: Track number (1-based). Return tracks come after session tracks.

  • volume: Normalized volume 0.0–1.0. Use 0.85 for unity (0 dB).

Inputs: volume (required), track_index (required). Returns: result

set_wavetable_modulationA

Set one cell of Wavetable's modulation matrix.

Sources: amp_envelope, envelope_2, envelope_3, lfo_1, lfo_2, midi_note, midi_velocity, midi_mod_wheel, midi_pitch_bend, midi_channel_pressure, midi_random.

Live 11's API documented no setter for this; if this build has none the call reports that rather than failing silently.

Parameters:

  • track_index: Track number (1-based).

  • target_index: Matrix target index from get_wavetable_state.

  • source: Modulation source name.

  • value: Modulation amount.

  • device_index: Device number on the track (1-based).

  • chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Inputs: value (required), source (required), track_index (required), target_index (required), +2 more. Returns: result

set_wavetable_propertyA

Set a Wavetable property that is not a device parameter.

Writable names: oscillator_1_wavetable_category / oscillator_1_wavetable_index oscillator_2_wavetable_category / oscillator_2_wavetable_index oscillator_1_effect_mode / oscillator_2_effect_mode (0=None 1=FM 2=Classic 3=Modern) filter_routing (0=Serial 1=Parallel 2=Split) mono_poly (0=Mono 1=Poly) poly_voices, unison_mode, unison_voice_count

Parameters:

  • track_index: Track number (1-based).

  • name: Property name from the list above.

  • value: Integer value.

  • device_index: Device number on the track (1-based).

  • chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Inputs: name (required), value (required), track_index (required), chain_index, +1 more. Returns: result

start_playbackB

Start playing the Ableton session.

Inputs: no named parameters. Returns: result

stop_clipA

Stop playing a clip.

Parameters:

  • track_index: Track number (1-based).

  • clip_index: Clip slot number (1-based).

Inputs: clip_index (required), track_index (required). Returns: result

stop_playbackB

Stop playing the Ableton session.

Inputs: no named parameters. Returns: result

undoA

Undo the last action in Live.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 71 tools

    Disambiguation3/5

    Most tools target a distinct resource and action, but a few pairs blur together: set_clip_name overlaps with set_clip_property, and get_session_info, get_session_snapshot, and get_arrangement_info all promise broad state dumps. The detailed descriptions help, but an agent could easily misselect between these similar-sounding entry points.

    Naming Consistency5/5

    The entire toolset follows a consistent verb_noun snake_case pattern: create_midi_track, set_track_volume, delete_scene, get_clip_notes. Even less standard verbs like manage, control, navigate, and describe fit naturally within the same convention.

    Tool Count2/5

    At 71 tools, this is far beyond the comfortable MCP server range and will create a large, unwieldy selection surface for agents. While Ableton is a broad DAW, the count feels bloated and includes redundant tools such as set_clip_name alongside set_clip_property.

    Completeness4/5

    The tool surface covers most core DAW workflows: track creation and mixing, session and arrangement clips, MIDI editing, scenes, cue points, devices, browser loading, and undo/redo. Minor gaps remain, such as creating session audio clips and explicit recording/export control, but agents can accomplish common tasks without dead ends.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      MCP server for controlling Ableton Live, enabling AI assistants to interact with Live sessions through tools for track/clip/scene management, playback control, and device parameter adjustments.
      48
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that exposes Ableton Live control (session state, transport, tracks, devices, clips, MIDI note editing) as tools for LLM agents, enabling natural language manipulation of a Live session.
      1
      MIT