ableton-copilot-mcp

🎯 Note

As a music producer myself, I understand the challenges and needs during the music creation process. This tool aims to provide Ableton users with an intelligent and practical auxiliary system to make the creative process more natural and smooth. I always adhere to the core concept of "assisting creation" rather than blindly pursuing AI to generate complete musical notes – truly moving musical works are inseparable from unique human creativity and artistic perception, which is currently beyond the reach of AI technology.

🚀 Features

🎵 Song Control

• Get basic song information (root note, scale name, tempo, song length, etc.)
• Get a list of all tracks
• Create MIDI, audio, and return tracks
• Delete and duplicate tracks

🎹 Track Management

• Get all clips in a track
• Create empty MIDI clips
• Set track properties (mute, color, name, arm, solo, etc.)
• Duplicate MIDI clips to specified tracks

🎼 Clip Operations

• Get clips in the piano roll view
• Get and manage all notes in a clip
• Add, delete, and replace notes in clips
• Set clip properties (name, color, looping, loop_start, loop_end, etc.)

🎧 Audio Operations

• Supports recording track content based on time range

📝 To-Do List

• Add recording and playback of user operations
• Support direct moving of track positions
• Support direct loading of instruments and effects
• Others...

⚠️ Warning

• 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.

📥 Installation

1. Install Node.js: Make sure the npx command is available. It's recommended to install the latest stable version from the Node.js official website
2. Install MIDI Remote Scripts: Follow the instructions from the ableton-js project to install AbletonJS MIDI Remote Scripts to your Ableton Live

🔧 Usage

1. Ensure that Ableton Live is launched and running

2. Make sure AbletonJS Control Surface is enabled in your configuration:

   Path: Settings -> Link, Tempo & MIDI -> MIDI -> Control Surface

   

   Figure 1: Enabling AbletonJS Control Surface in Ableton Live Configuration

3. Connect using an MCP client, including but not limited to:

   • Cursor
   • Cherry Studio
   • Claude Desktop

Cursor Configuration Example

Configure ableton-copilot-mcp in Cursor:

Currently, Cursor supports a maximum of 40 MCP tools, which may cause some features to be unavailable.

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "ableton-copilot-mcp"
    ]
}

✅ Compatibility Testing

Compatibility primarily depends on the version support of the ableton-js library.

Ableton Live Version	Test Status
12.1.10	✅ Tested and working
11.x	⚠️ Not tested yet
10.x	⚠️ Not tested yet

🤝 Contributing

Issues and contributions are welcome. Please submit issues or suggestions through GitHub Issues.

📄 License

This project is licensed under the MIT License.