AL

Ableton Live

Created 6 months ago

Ableton Live MCP Server facilitates communication between LLMs and Ableton Live using OSC.

development documentation public MCP Ableton Live

What is Ableton Live?

an MCP server to control Ableton Live.

Documentation

Ableton Live MCP Server

Overview

The Ableton Live MCP Server is a server implementing the Model Context Protocol (MCP) to facilitate communication between LLMs and Ableton Live. It uses OSC (Open Sound Control) to send and receive messages to/from Ableton Live. It is based on AbletonOSC implementation and exhaustively maps available OSC addresses to tools accessible to MCP clients.

Features

  • Provides an MCP-compatible API for controlling Ableton Live from MCP clients.
  • Uses python-osc for sending and receiving OSC messages.
  • Based on the OSC implementation from AbletonOSC.
  • Implements request-response handling for Ableton Live commands.

Installation# Requirements

  • Python 3.8+
  • python-osc (for OSC communication)
  • fastmcp (for MCP support)
  • uv (recommended Python package installer)
  • AbletonOSC as a control surface

Installation Steps

  1. Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Clone the repository: git clone https://github.com/your-username/mcp_ableton_server.git
  3. Install the project and its dependencies: uv sync
  4. Install AbletonOSC

Usage# Running the OSC Daemon

The OSC daemon will handle OSC communication between the MCP server and Ableton Live: uv run osc_daemon.py

Example Usage

In Claude desktop, ask Claude: - Prepare a set to record a rock band - Set the input routing channel of all tracks that have "voice" in their name to Ext. In 2

Configuration

By default, the server and daemon run on localhost (127.0.0.1) with the following ports:

  • MCP Server Socket: 65432
  • Ableton Live OSC Port (Send): 11000
  • Ableton Live OSC Port (Receive): 11001

To modify these, edit the AbletonOSCDaemon class in osc_daemon.py.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Server Config

{
  "mcpServers": {
    "ableton-live-server": {
      "command": "npx",
      "args": [
        "ableton-live"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: Simon Kansara
Category: community
License: MIT License
Tags:
development documentation public