Skip to content
Back to search

ableton-mcp-extended

Ableton Live MCP (Model Context Protocol) server that allows control directly through AI assistants.

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/uisato--ableton-mcp-extended/badge.svg)](/listings/uisato--ableton-mcp-extended)

HTML

<a href="/listings/uisato--ableton-mcp-extended"><img src="/api/listings/uisato--ableton-mcp-extended/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.

Prerequisites

- Ableton Live 11+ (any edition) - Python 3.10 or higher - Claude Desktop or Cursor IDE

1. **Get the Code**

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

2. **Install Ableton Script**

1. Find your Ableton User Library Remote Scripts folder: - **Windows**: `C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\` - **Mac**: `~/Music/Ableton/User Library/Remote Scripts/` 2. Create folder: `AbletonMCP` 3. Copy `AbletonMCP_Remote_Script/__init__.py` into this folder

3. **Configure Ableton**

1. Open Ableton Live 2. Go to **Preferences** → **Link, Tempo & MIDI** 3. Set **Control Surface** to "AbletonMCP" 4. Set Input/Output to "None"

4. **Connect AI Assistant**

**For Claude Desktop:**

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

**For Cursor:** Add MCP server in Settings → MCP with the same path.

5. **Start Creating!**

Open your AI assistant and try: - *"Create a new MIDI track with a piano"* - *"Add a simple drum beat"* - *"What tracks do I currently have?"*

---

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 · 284 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Ableton MCP Extended
  2. **Control Ableton Live using natural language via AI assistants like Claude or Cursor. This project provides a robust Model Context Protocol (MCP) server that translates natural language commands into precise actions within your Ableton Live session.**
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
  5. [![Ableton Live 11+](https://img.shields.io/badge/Ableton%20Live-11+-orange.svg)](https://www.ableton.com/)
  6. ---
  7. Video demonstration: https://www.youtube.com/watch?v=7ZKPIrJuuKk
  8. This tool is designed for producers, developers, and AI enthusiasts who want to streamline their music production workflow, experiment with generative music, and build custom integrations with Ableton Live.
  9. **You can transform this conversation:**
  10. ```
  11. 👤 "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."
  12. 🤖 "Creating MIDI clips... Adding effects... Done!"
  13. 👤 "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."
  14. 🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"
  15. ```
  16. **Into this music production session**:
  17. https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3
  18. ---
  19. ## Key Features
  20. This project provides comprehensive, programmatic control over the Ableton Live environment.
  21. * **Session and Transport Control:**
  22. * Start and stop playback.
  23. * Get session info, including tempo, time signature, and track count.
  24. * Manage scenes: create, delete, rename, and fire.
  25. * **Track Management:**
  26. * Create, rename, and get detailed information for MIDI and audio tracks.
  27. * Control track properties: volume, panning, mute, solo, and arm.
  28. * Manage track grouping and folding states.
  29. * **MIDI Clip and Note Manipulation:**
  30. * Create and name MIDI clips with specified lengths.
  31. * Add, delete, transpose, and quantize notes within clips.
  32. * Perform batch edits on multiple notes in a single operation.
  33. * Adjust clip loop parameters and follow actions.
  34. * **Device and Parameter Control:**
  35. * Load instruments and effects from Ableton's browser by URI.
  36. * Get a full list of parameters for any device on a track.
  37. * Set and batch-set device parameters using normalized values (0.0 to 1.0).
  38. * **Automation and Envelopes:**
  39. * Add and clear automation points for any device parameter within a clip. [This feature isn't working perfectly yet.]
  40. * Get information about existing clip envelopes.
  41. * **Browser Integration:**
  42. * Navigate and list items from Ableton's browser.
  43. * Load instruments, effects, and samples directly from a browser path or URI.
  44. * Import audio files directly into audio tracks or clip slots.
  45. * **Voice & Audio Generation**
  46. * Text-to-Speech Integration: Generate narration, vocal samples, or spoken elements through ElevenLabs MCP [included].
  47. * Custom Voice Creation: Clone voices for unique character in your tracks
  48. * Sound Effects: Create custom SFX with AI
  49. * Direct Import: Generated audio appears instantly in your Ableton session
  50. * **Extensible Framework for Custom Tools**
  51. * Example: XY Mouse Controller: Demonstrates creating custom Ableton controllers with the MCP framework
  52. * Ultra-Low Latency: High-performance UDP protocol enables responsive real-time control
  53. * Unlimited Possibilities: Build your own custom tools and controllers for Ableton Live
  54. ---
  55. ## Quick Start (5 Minutes)
  56. ### Prerequisites
  57. - Ableton Live 11+ (any edition)
  58. - Python 3.10 or higher
  59. - Claude Desktop or Cursor IDE
  60. ### 1. **Get the Code**
  61. ```bash
  62. git clone https://github.com/uisato/ableton-mcp-extended.git
  63. cd ableton-mcp-extended
  64. pip install -e .
  65. ```
  66. ### 2. **Install Ableton Script**
  67. 1. Find your Ableton User Library Remote Scripts folder:
  68. - **Windows**: `C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\`
  69. - **Mac**: `~/Music/Ableton/User Library/Remote Scripts/`
  70. 2. Create folder: `AbletonMCP`
  71. 3. Copy `AbletonMCP_Remote_Script/__init__.py` into this folder
  72. ### 3. **Configure Ableton**
  73. 1. Open Ableton Live
  74. 2. Go to **Preferences** → **Link, Tempo & MIDI**
  75. 3. Set **Control Surface** to "AbletonMCP"
  76. 4. Set Input/Output to "None"
  77. ### 4. **Connect AI Assistant**
  78. **For Claude Desktop:**
  79. ```json
  80. {
  81. "mcpServers": {
  82. "AbletonMCP": {
  83. "command": "python",
  84. "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
  85. }
  86. }
  87. }
  88. ```
  89. **For Cursor:**
  90. Add MCP server in Settings → MCP with the same path.
  91. ### 5. **Start Creating!**
  92. Open your AI assistant and try:
  93. - *"Create a new MIDI track with a piano"*
  94. - *"Add a simple drum beat"*
  95. - *"What tracks do I currently have?"*
  96. ---
  97. ## How It Works
  98. ```mermaid
  99. graph TB
  100. A[You: Natural Language] --> B[AI Assistant]
  101. B --> C[MCP Server]
  102. C --> D[Ableton Remote Script]
  103. D --> E[Ableton Live API]
  104. E --> F[🎵 Your Music]
  105. G[ElevenLabs AI] --> H[Generated Audio]
  106. H --> C
  107. ```
  108. 1. You issue a command in plain English to your AI assistant (e.g., "Create a new MIDI track and name it 'Bass'").
  109. 2. The AI Assistant understands the intent and calls the appropriate tool from the MCP server.
  110. 3. The MCP Server (server.py) receives the tool call and constructs a specific JSON command.
  111. 4. The Ableton Remote Script (__init__.py), running inside Live, receives the JSON command via a socket connection.
  112. 5. The Remote Script executes the command using the official Ableton Live API, making the change in your session instantly.
  113. ---
  114. ## Advanced Features
  115. <details>
  116. <summary><strong>🚀 High-Performance Mode (UDP Server)</strong></summary>
  117. For real-time parameter control with ultra-low latency:
  118. ```bash
  119. # Install the hybrid server
  120. cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/
  121. # Try the XY Mouse Controller example
  122. cd experimental_tools/xy_mouse_controller
  123. python mouse_parameter_controller_udp.py
  124. ```
  125. This demonstrates how to build:
  126. - Custom real-time controllers for Ableton
  127. - Expressive performance tools
  128. - Interactive music applications
  129. </details>
  130. <details>
  131. <summary><strong>🎤 ElevenLabs Voice Integration</strong></summary>
  132. This repository can be integrated with other MCP servers, such as one for ElevenLabs, to generate and import audio directly into your project.
  133. Set up the ElevenLabs MCP server according to its instructions.
  134. Update your AI assistant's config to include both servers.
  135. Example mcp-config.json:
  136. ```json
  137. {
  138. "mcpServers": {
  139. "AbletonMCP": {
  140. "command": "python",
  141. "args": ["/path/to/ableton-mcp-extended/server.py"]
  142. },
  143. "ElevenLabs": {
  144. "command": "python",
  145. "args": ["/path/to/elevenlabs_mcp/server.py"],
  146. "env": {
  147. "ELEVENLABS_API_KEY": "your-api-key-here"
  148. }
  149. }
  150. }
  151. }
  152. ```
  153. </details>
  154. ---
  155. ## Components Overview
  156. This project includes several specialized components:
  157. ### **Core MCP Server**
  158. - Standard TCP communication for reliable AI control
  159. - Extensive Ableton Live API integration
  160. - Compatible with Claude Desktop, Cursor, and Gemini CLI.
  161. ### **Hybrid TCP/UDP Server**
  162. - High-performance real-time parameter control
  163. - Ultra-low latency for live performance
  164. - Perfect for controllers and interactive tools
  165. ### **ElevenLabs Integration**
  166. - Professional text-to-speech generation
  167. - Custom voice creation and cloning
  168. - Direct import into Ableton sessions
  169. - Real-time SFX generation
  170. ### **Experimental Tools & Examples**
  171. - **XY Mouse Controller**: Example demonstrating how to build custom Ableton controllers
  172. - **Extensible Framework**: Foundation for creating your own control interfaces
  173. - **Proof of Concept**: Shows the power and flexibility of the MCP approach
  174. ---
  175. ## Documentation
  176. - **[Installation Guide](INSTALLATION.md)** - Detailed setup instructions
  177. - **[User Guide](README.md)** - What, which, and how
  178. ---
  179. ## Community & Support
  180. - **GitHub Issues**: Bug reports and feature requests
  181. - **Discussions**: Share your creations and get help
  182. ### **Share Your Creations**
  183. Tag me with your AI-generated experiments! I love seeing what the community creates:
  184. [YouTube](https://www.youtube.com/@uisato_) |
  185. [Instagram](https://www.instagram.com/uisato_) |
  186. [Patreon](https://www.patreon.com/c/uisato) |
  187. [Website](https://www.uisato.art/)
  188. ---
  189. ## What's Next
  190. - **Fixing Automation Point Placement Bugs**
  191. - ~**VST Plugin Support** - Control third-party plugins [Though it can be achieved throught the "Configure" parameter function]~ → Done!
  192. - **Arrangement View** - Full timeline control
  193. - **Hardware Integration** - Bridge MIDI controllers through AI
  194. - **Advanced AI** - Smarter and better music understanding and generation
  195. ---
  196. ## License & Credits
  197. This project is licensed under the MIT License - see [LICENSE](LICENSE) for details.
  198. **Built with:**
  199. - [Model Context Protocol](https://github.com/modelcontextprotocol) - AI integration framework
  200. - [ElevenLabs API](https://elevenlabs.io) - Professional voice generation
  201. - [Ableton Live](https://www.ableton.com) - Digital audio workstation
  202. **Inspired by:** The original [ableton-mcp](https://github.com/ahujasid/ableton-mcp) project
  203. ---
  204. <div align="center">
  205. **Made with ❤️ for the music production community**
  206. *If this project helps your creativity, consider giving it a ⭐ star!*
  207. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

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