Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Installation

Installing remix-mcp

Via uv (Recommended)

uv is a fast Python package installer that can run Rust binaries:

uvx remix-mcp install

This 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 --release

The 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 install

This copies the AbletonOSC folder to your Ableton Remote Scripts directory:

PlatformPath
macOS~/Music/Ableton/User Library/Remote Scripts/
Windows%USERPROFILE%\Documents\Ableton\User Library\Remote Scripts\

Enable in Ableton

  1. Restart Ableton Live (required after installing scripts)
  2. Open Preferences (Cmd+, / Ctrl+,)
  3. Navigate to Link/Tempo/MIDI
  4. Under Control Surface, select AbletonOSC

Check Status

Verify installation:

remix-mcp status

Reinstall

Force reinstall if needed:

remix-mcp install --force

Network Ports

remix-mcp communicates with AbletonOSC over UDP:

PortDirectionPurpose
11000remix-mcp -> AbletonSend OSC commands
11001Ableton -> remix-mcpReceive responses

Ensure these ports are not blocked by firewalls or used by other applications.