ableton-live-mcp-server
MCP Server implementation for Ableton Live OSC control
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/simon-kansara--ableton-live-mcp-server)HTML
<a href="/listings/simon-kansara--ableton-live-mcp-server"><img src="/api/listings/simon-kansara--ableton-live-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Requirements
- Python 3.8+ - `python-osc` (for OSC communication) - `fastmcp` (for MCP support) - `uv` (recommended Python package installer) - [AbletonOSC](https://github.com/ideoforms/AbletonOSC) as a control surface
Installation Steps
1. Install `uv` (https://docs.astral.sh/uv/getting-started/installation):
curl -LsSf https://astral.sh/uv/install.sh | sh
2. Clone the repository:
git clone https://github.com/your-username/mcp_ableton_server.git cd mcp_ableton_server
3. Install the project and its dependencies:
uv sync
4. Install AbletonOSC Follow the instructions at [AbletonOSC](https://github.com/ideoforms/AbletonOSC)
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 159 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Ableton Live MCP Server
- ## 📌 Overview
- The **Ableton Live MCP Server** is a server implementing the
- [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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](https://github.com/ideoforms/AbletonOSC) implementation and
- exhaustively maps available OSC adresses to
- [**tools**](https://modelcontextprotocol.io/docs/concepts/tools) accessible to
- MCP clients.
- [](https://www.youtube.com/watch?v=12MzsQ3V7cs)
- This project consists of two main components:
- - `mcp_ableton_server.py`: The MCP server handling the communication between
- clients and the OSC daemon.
- - `osc_daemon.py`: The OSC daemon responsible for relaying commands to Ableton
- Live and processing responses.
- ## ✨ 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](https://github.com/ideoforms/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](https://github.com/ideoforms/AbletonOSC) as a control surface
- ### Installation Steps
- 1. Install `uv` (https://docs.astral.sh/uv/getting-started/installation):
- ```bash
- curl -LsSf https://astral.sh/uv/install.sh | sh
- ```
- 2. Clone the repository:
- ```bash
- git clone https://github.com/your-username/mcp_ableton_server.git
- cd mcp_ableton_server
- ```
- 3. Install the project and its dependencies:
- ```bash
- uv sync
- ```
- 4. Install AbletonOSC Follow the instructions at
- [AbletonOSC](https://github.com/ideoforms/AbletonOSC)
- ## 🚀 Usage
- ### Running the OSC Daemon
- The OSC daemon will handle OSC communication between the MCP server and Ableton
- Live:
- ```bash
- uv run osc_daemon.py
- ```
- This will:
- - Listen for MCP client connections on port **65432**.
- - Forward messages to Ableton Live via OSC on port **11000**.
- - Receive OSC responses from Ableton on port **11001**.
- ### 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`:
- ```python
- self.socket_host = '127.0.0.1'
- self.socket_port = 65432
- self.ableton_host = '127.0.0.1'
- self.ableton_port = 11000
- self.receive_port = 11001
- ```
- ### Claude Desktop Configuration
- To use this server with Claude Desktop, you need to configure it in your Claude
- Desktop settings. The configuration file location varies by operating system:
- - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- - Windows: `%APPDATA%/Claude/claude_desktop_config.json`
- Add the following configuration to your `mcpServers` section:
- ```json
- {
- "mcpServers": {
- "Ableton Live Controller": {
- "command": "/path/to/your/project/.venv/bin/python",
- "args": ["/path/to/your/project/mcp_ableton_server.py"]
- }
- }
- ```
- This configuration ensures that:
- - The server runs with all dependencies properly managed
- - The project remains portable and reproducible
- ## Contributing
- Feel free to submit issues, feature requests, or pull requests to improve this
- project.
- ## License
- This project is licensed under the **MIT License**. See the `LICENSE` file for
- details.
- ## Acknowledgments
- - [Model Context Protocol (MCP)](https://modelcontextprotocol.io)
- - [python-osc](https://github.com/attwad/python-osc) for OSC handling
- - Daniel John Jones for OSC implementation with
- [AbletonOSC](https://github.com/ideoforms/AbletonOSC)
- - Ableton Third Party Remote Scripts
- - Julien Bayle @[Structure Void](https://structure-void.com/) for endless
- inspirations and resources.
- ## TODO
- - Explore _resources_ and _prompts_ primitives opportunities.
- - Build a standalone Ableton Live MCP client.
- ---
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.