Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/simon-kansara--ableton-live-mcp-server/badge.svg)](/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

i

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)

  1. # Ableton Live MCP Server
  2. ## 📌 Overview
  3. The **Ableton Live MCP Server** is a server implementing the
  4. [Model Context Protocol (MCP)](https://modelcontextprotocol.io) to facilitate
  5. communication between LLMs and **Ableton Live**. It uses **OSC (Open Sound
  6. Control)** to send and receive messages to/from Ableton Live. It is based on
  7. [AbletonOSC](https://github.com/ideoforms/AbletonOSC) implementation and
  8. exhaustively maps available OSC adresses to
  9. [**tools**](https://modelcontextprotocol.io/docs/concepts/tools) accessible to
  10. MCP clients.
  11. [![Control Ableton Live with LLMs](https://img.youtube.com/vi/12MzsQ3V7cs/hqdefault.jpg)](https://www.youtube.com/watch?v=12MzsQ3V7cs)
  12. This project consists of two main components:
  13. - `mcp_ableton_server.py`: The MCP server handling the communication between
  14. clients and the OSC daemon.
  15. - `osc_daemon.py`: The OSC daemon responsible for relaying commands to Ableton
  16. Live and processing responses.
  17. ## ✨ Features
  18. - Provides an MCP-compatible API for controlling Ableton Live from MCP clients.
  19. - Uses **python-osc** for sending and receiving OSC messages.
  20. - Based on the OSC implementation from
  21. [AbletonOSC](https://github.com/ideoforms/AbletonOSC).
  22. - Implements request-response handling for Ableton Live commands.
  23. ## ⚡ Installation
  24. ### Requirements
  25. - Python 3.8+
  26. - `python-osc` (for OSC communication)
  27. - `fastmcp` (for MCP support)
  28. - `uv` (recommended Python package installer)
  29. - [AbletonOSC](https://github.com/ideoforms/AbletonOSC) as a control surface
  30. ### Installation Steps
  31. 1. Install `uv` (https://docs.astral.sh/uv/getting-started/installation):
  32. ```bash
  33. curl -LsSf https://astral.sh/uv/install.sh | sh
  34. ```
  35. 2. Clone the repository:
  36. ```bash
  37. git clone https://github.com/your-username/mcp_ableton_server.git
  38. cd mcp_ableton_server
  39. ```
  40. 3. Install the project and its dependencies:
  41. ```bash
  42. uv sync
  43. ```
  44. 4. Install AbletonOSC Follow the instructions at
  45. [AbletonOSC](https://github.com/ideoforms/AbletonOSC)
  46. ## 🚀 Usage
  47. ### Running the OSC Daemon
  48. The OSC daemon will handle OSC communication between the MCP server and Ableton
  49. Live:
  50. ```bash
  51. uv run osc_daemon.py
  52. ```
  53. This will:
  54. - Listen for MCP client connections on port **65432**.
  55. - Forward messages to Ableton Live via OSC on port **11000**.
  56. - Receive OSC responses from Ableton on port **11001**.
  57. ### Example Usage
  58. In Claude desktop, ask Claude:
  59. - _Prepare a set to record a rock band_
  60. - _Set the input routing channel of all tracks that have "voice" in their name
  61. to Ext. In 2_
  62. ## ⚙️ Configuration
  63. By default, the server and daemon run on **localhost (127.0.0.1)** with the
  64. following ports:
  65. - **MCP Server Socket:** 65432
  66. - **Ableton Live OSC Port (Send):** 11000
  67. - **Ableton Live OSC Port (Receive):** 11001
  68. To modify these, edit the `AbletonOSCDaemon` class in `osc_daemon.py`:
  69. ```python
  70. self.socket_host = '127.0.0.1'
  71. self.socket_port = 65432
  72. self.ableton_host = '127.0.0.1'
  73. self.ableton_port = 11000
  74. self.receive_port = 11001
  75. ```
  76. ### Claude Desktop Configuration
  77. To use this server with Claude Desktop, you need to configure it in your Claude
  78. Desktop settings. The configuration file location varies by operating system:
  79. - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  80. - Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  81. Add the following configuration to your `mcpServers` section:
  82. ```json
  83. {
  84. "mcpServers": {
  85. "Ableton Live Controller": {
  86. "command": "/path/to/your/project/.venv/bin/python",
  87. "args": ["/path/to/your/project/mcp_ableton_server.py"]
  88. }
  89. }
  90. ```
  91. This configuration ensures that:
  92. - The server runs with all dependencies properly managed
  93. - The project remains portable and reproducible
  94. ## Contributing
  95. Feel free to submit issues, feature requests, or pull requests to improve this
  96. project.
  97. ## License
  98. This project is licensed under the **MIT License**. See the `LICENSE` file for
  99. details.
  100. ## Acknowledgments
  101. - [Model Context Protocol (MCP)](https://modelcontextprotocol.io)
  102. - [python-osc](https://github.com/attwad/python-osc) for OSC handling
  103. - Daniel John Jones for OSC implementation with
  104. [AbletonOSC](https://github.com/ideoforms/AbletonOSC)
  105. - Ableton Third Party Remote Scripts
  106. - Julien Bayle @[Structure Void](https://structure-void.com/) for endless
  107. inspirations and resources.
  108. ## TODO
  109. - Explore _resources_ and _prompts_ primitives opportunities.
  110. - Build a standalone Ableton Live MCP client.
  111. ---

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.