Installation
Installing remix-mcp
Via uv (Recommended)
uv is a fast Python package installer that can run Rust binaries:
uvx remix-mcp installThis downloads and runs the latest release automatically.
Download Binary
Download pre-built binaries for your platform from GitHub Releases:
- macOS (Apple Silicon):
remix-mcp-aarch64-apple-darwin.tar.gz - macOS (Intel):
remix-mcp-x86_64-apple-darwin.tar.gz - Linux:
remix-mcp-x86_64-unknown-linux-gnu.tar.gz - Windows:
remix-mcp-x86_64-pc-windows-msvc.zip
Extract and add to your PATH.
Build from Source
Requires Rust:
git clone --recursive https://github.com/christopherwxyz/remix-mcp
cd remix-mcp
cargo build --releaseThe binary will be at target/release/remix-mcp.
Installing AbletonOSC
AbletonOSC is a Remote Script that runs inside Ableton Live, exposing its API over OSC.
Automatic Installation
remix-mcp installThis copies the AbletonOSC folder to your Ableton Remote Scripts directory:
| Platform | Path |
|---|---|
| macOS | ~/Music/Ableton/User Library/Remote Scripts/ |
| Windows | %USERPROFILE%\Documents\Ableton\User Library\Remote Scripts\ |
Enable in Ableton
- Restart Ableton Live (required after installing scripts)
- Open Preferences (
Cmd+,/Ctrl+,) - Navigate to Link/Tempo/MIDI
- Under Control Surface, select AbletonOSC
Check Status
Verify installation:
remix-mcp statusReinstall
Force reinstall if needed:
remix-mcp install --forceNetwork Ports
remix-mcp communicates with AbletonOSC over UDP:
| Port | Direction | Purpose |
|---|---|---|
| 11000 | remix-mcp -> Ableton | Send OSC commands |
| 11001 | Ableton -> remix-mcp | Receive responses |
Ensure these ports are not blocked by firewalls or used by other applications.