Skip to content
Back to search

ableton-copilot-mcp

An MCP server built on ableton-js enables AI assistants to control Ableton Live in real time, including Arrangement View operations such as song management, track control, MIDI editing, and audio recording, along with other capabilities.

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

HTML

<a href="/listings/xiaolaa2--ableton-copilot-mcp"><img src="/api/listings/xiaolaa2--ableton-copilot-mcp/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

- **Node.js** environment: Ensure Node.js is installed (v20+ recommended) and the `npx` command is available > πŸ”— Download: [Node.js official website](https://nodejs.org/)

Installation Steps

1. Install AbletonJS MIDI Remote Scripts

Choose **ONE** of the following three methods to install MIDI Remote Scripts:

- **Method 1: One-line installation (Recommended)**

  npx @xiaolaa2/ableton-copilot-mcp --install-scripts
  # or use the short form
  npx @xiaolaa2/ableton-copilot-mcp -is

- **Method 2: Tool-assisted installation** 1. First, start ableton-copilot-mcp (see Usage section below) 2. Let AI assistant or manually call the MCP tool `init_ableton_js` to complete the installation automatically

- **Method 3: Manual installation** 1. Create a folder named "Remote Scripts" in your Ableton User Library: - Windows: `C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts` - Mac: `/Users/[username]/Music/Ableton/User Library/Remote Scripts` 2. Download MIDI Remote Scripts from the [ableton-js](https://github.com/leolabs/ableton-js) project 3. Copy the downloaded `midi-script` folder to the location above 4. Rename it to `AbletonJS`

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 Β· 182 lines

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

  1. # ableton-copilot-mcp
  2. <div align="center">
  3. <img src="https://img.shields.io/badge/Ableton%20Live-12-9cf" alt="Ableton Live Version">
  4. <img src="https://img.shields.io/badge/Node.js-20%2B-green" alt="Node.js Version">
  5. <img src="https://img.shields.io/badge/TypeScript-5.8.2-blue" alt="TypeScript Version">
  6. <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
  7. </div>
  8. > An MCP (Model Context Protocol) server built on [ableton-js](https://github.com/leolabs/ableton-js) for real-time interaction and control with Ableton Live's Arrangement View, dedicated to assisting music producers in their music production.
  9. ## 🎯 Note
  10. As a music producer, I have some understanding of using Ableton for music creation. During the creative process, we often need to handle various tedious operations, such as humanizing note properties, merging notes, recording one track to another audio track, etc. Previously, we could only rely on the functions provided by the host DAW for these operations. However, with the emergence of large language models and MCP, we now have the possibility to let AI help us with automation. Although it's still not realistic for AI to directly generate notes or create a complete song (it can't generate a good-sounding song), having AI assist us with auxiliary operations presents a new possibility.
  11. ## πŸŽ₯ Demo
  12. This is a simple demonstration video of MIDI operations.
  13. https://github.com/user-attachments/assets/8d635c4c-a1f2-44be-93ae-062038d14c71
  14. ## πŸš€ Features
  15. ### 🎡 Song Control
  16. - Get basic song information (root note, scale name, tempo, song length, etc.)
  17. - Get a list of all tracks
  18. - Create MIDI, audio, and return tracks
  19. - Delete and duplicate tracks
  20. ### 🎹 Track Management
  21. - Get all clips in a track
  22. - Create empty MIDI clips in the arrangement view tracks
  23. - Create audio clips in tracks based on provided sample file paths
  24. - Set track properties (mute, color, name, arm, solo, etc.)
  25. - Duplicate MIDI clips to specified tracks
  26. ### 🎼 Clip Operations
  27. - Get clips in the piano roll view
  28. - Get and manage all notes in a clip
  29. - Add, delete, and replace notes in clips
  30. - Set clip properties (name, color, looping, loop_start, loop_end, etc.)
  31. ### 🎧 Audio Operations
  32. - Supports recording track content based on time range
  33. ### πŸ”Œ Device Management
  34. - Load audio effects, instruments and plugins
  35. - Modify device parameters
  36. - Browse available devices in the library
  37. ### πŸ“ State Management
  38. - Operation history tracking and detailed logging
  39. - Support for operation rollback (currently only supports note operations)
  40. - Browse and restore previous states
  41. ## πŸ“ To-Do List
  42. - Support automatic envelope adjustment
  43. - Support more snapshot types (track properties, device parameters, etc.)
  44. ## ⚠️ Warning
  45. - Direct manipulation of MIDI clips by AI may result in the loss of original notes and cannot be undone with Ctrl + Z. Please operate with caution. If needed, you can ask the AI to help you roll back note operations.
  46. ## πŸ“₯ Installation
  47. ### Prerequisites
  48. - **Node.js** environment: Ensure Node.js is installed (v20+ recommended) and the `npx` command is available
  49. > πŸ”— Download: [Node.js official website](https://nodejs.org/)
  50. ### Installation Steps
  51. #### 1. Install AbletonJS MIDI Remote Scripts
  52. Choose **ONE** of the following three methods to install MIDI Remote Scripts:
  53. - **Method 1: One-line installation (Recommended)**
  54. ```bash
  55. npx @xiaolaa2/ableton-copilot-mcp --install-scripts
  56. # or use the short form
  57. npx @xiaolaa2/ableton-copilot-mcp -is
  58. ```
  59. - **Method 2: Tool-assisted installation**
  60. 1. First, start ableton-copilot-mcp (see Usage section below)
  61. 2. Let AI assistant or manually call the MCP tool `init_ableton_js` to complete the installation automatically
  62. - **Method 3: Manual installation**
  63. 1. Create a folder named "Remote Scripts" in your Ableton User Library:
  64. - Windows: `C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts`
  65. - Mac: `/Users/[username]/Music/Ableton/User Library/Remote Scripts`
  66. 2. Download MIDI Remote Scripts from the [ableton-js](https://github.com/leolabs/ableton-js) project
  67. 3. Copy the downloaded `midi-script` folder to the location above
  68. 4. Rename it to `AbletonJS`
  69. ## πŸ”§ Usage
  70. ### Quick Start
  71. 1. **Launch Ableton Live**
  72. 2. **Enable AbletonJS Control Surface**
  73. - Open Ableton Live Preferences: `Preferences` β†’ `Link/MIDI`
  74. - In the `MIDI` tab, locate the `Control Surface` section
  75. - Select `AbletonJS` from the dropdown menu
  76. <div align="center">
  77. <img src="./assets/images/setting.jpg" alt="Ableton Live MIDI Remote Scripts Configuration" width="80%" style="border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
  78. <p><em>Figure 1: Enabling AbletonJS Control Surface in Ableton Live Configuration</em></p>
  79. </div>
  80. 3. **Connect using an MCP client**
  81. The following clients can be used as MCP endpoints:
  82. - [Cursor](https://www.cursor.com)
  83. - [Cherry Studio](https://github.com/CherryHQ/cherry-studio)
  84. - Claude Desktop
  85. - Other MCP clients
  86. ### Client Configuration
  87. #### Cursor Configuration Example
  88. Add the following configuration to your Cursor settings:
  89. ```json
  90. "ableton-js-mcp": {
  91. "command": "npx",
  92. "args": [
  93. "-y",
  94. "@xiaolaa2/ableton-copilot-mcp"
  95. ]
  96. }
  97. ```
  98. For the latest version:
  99. ```json
  100. "ableton-js-mcp": {
  101. "command": "npx",
  102. "args": [
  103. "-y",
  104. "@xiaolaa2/ableton-copilot-mcp@latest"
  105. ]
  106. }
  107. ```
  108. #### Custom Storage Path (Optional)
  109. You can specify a custom data storage location using the `BASE_PATH` environment variable:
  110. ```json
  111. "ableton-js-mcp": {
  112. "command": "npx",
  113. "args": [
  114. "-y",
  115. "@xiaolaa2/ableton-copilot-mcp"
  116. ],
  117. "env": {
  118. "BASE_PATH": "D:\\ableton_copilot_mcp"
  119. }
  120. }
  121. ```
  122. > πŸ’‘ **Tip**: The storage path is used to save log files, operation history, and state snapshots
  123. ## βœ… Compatibility Testing
  124. Compatibility primarily depends on the version support of the [ableton-js](https://github.com/leolabs/ableton-js) library.
  125. | Ableton Live Version | Test Status |
  126. | -------------------- | ----------- |
  127. | 12.1.10 | βœ… Tested and working |
  128. | 11.x | ⚠️ Not tested yet |
  129. | 10.x | ⚠️ Not tested yet |
  130. ## 🀝 Contributing
  131. Issues and contributions are welcome. Please submit issues or suggestions through [GitHub Issues](https://github.com/xiaolaa2/ableton-copilot-mcp/issues).
  132. ## πŸ“„ License
  133. This project is licensed under the [MIT License](./LICENSE).
  134. ## ⚠️ Disclaimer
  135. This is a third-party integration and not made by Ableton.

Ratings and comments

Sign in to rate this skill.

Sign in

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