ableton-copilot-mcp

An MCP (Model Context Protocol) server based on ableton-js for real-time interaction and control with Ableton Live, dedicated to assisting music producers in music creation.

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

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

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:

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