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.

🤝 Contributing

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

📄 License

This project is licensed under the MIT License.