Skip to main content

MCP server for controlling Ableton Live via OSC

Project description

remix-mcp banner

A Rust MCP server that enables AI assistants to control Ableton Live via OSC.

CI Docs

📖 Documentation

Features

  • 266 tools for comprehensive Ableton Live control
  • Real-time OSC via AbletonOSC
  • Auto-installer for the AbletonOSC Remote Script
  • Cross-platform (macOS, Windows, Linux)

Quick Start

1. Install remix-mcp

Via uv (recommended, requires uv):

uvx remix-mcp install

Download binary from Releases

Build from source:

git clone --recursive https://github.com/christopherwxyz/remix-mcp
cd remix-mcp
cargo build --release

2. Install AbletonOSC

remix-mcp install

Then in Ableton Live:

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

You should see: AbletonOSC: Listening for OSC on port 11000

3. Add MCP Server

Claude Desktop:

  1. Open Claude Desktop Settings > Developer
  2. Click Edit Config to open claude_desktop_config.json
  3. Add the server configuration:
{
  "mcpServers": {
    "ableton": {
      "command": "uvx",
      "args": ["remix-mcp"]
    }
  }
}
  1. Restart Claude Desktop

Claude Code:

claude mcp add ableton -- uvx remix-mcp

Usage

Ask Claude things like:

  • "Create a MIDI track with Drift and add reverb"
  • "Set the tempo to 128 BPM"
  • "Create a 4-bar drum pattern"
  • "Add an arpeggiator to the selected track"
  • "Search the browser for bass sounds"

See the documentation for more examples.

Tools

Category Count Examples
Transport 10 play, stop, record, set_tempo
Tracks 59 create_midi_track, set_track_volume, arm_track
Clips 65 fire_clip, create_clip, add_midi_notes
Scenes 19 fire_scene, create_scene, duplicate_scene
Devices 10 list_devices, set_device_parameter
Song 56 undo, redo, set_loop, get_quantization
View 8 select_track, select_clip, select_device
Cue Points 5 list_cue_points, jump_to_cue_point
Browser 29 load_instrument, load_audio_effect, search_browser
Application 4 get_version, get_application_view
MIDI Map 1 get_midi_map_addresses

Architecture

Claude/Client <--stdio/JSON-RPC--> remix-mcp <--UDP/OSC--> AbletonOSC <--> Ableton Live

CLI

remix-mcp serve              # Start MCP server (default)
remix-mcp install            # Install AbletonOSC Remote Script
remix-mcp install --force    # Reinstall
remix-mcp status             # Check installation

Troubleshooting

No sound from MIDI tracks? Samplers need samples loaded. Use load_default_instrument to load Drift (a synth that works immediately).

Connection timeout?

  1. Check Ableton Live is running
  2. Verify AbletonOSC is enabled in Preferences > Link/Tempo/MIDI
  3. Ensure ports 11000/11001 are free

AbletonOSC not in Control Surface list?

  1. Run remix-mcp install
  2. Restart Ableton Live

Development

See the contributing guide for development guidelines.

License

MIT

Acknowledgments

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

remix_mcp-0.2.0-py3-none-win_amd64.whl (2.0 MB view details)

Uploaded Python 3Windows x86-64

remix_mcp-0.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.0 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

remix_mcp-0.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.9 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

remix_mcp-0.2.0-py3-none-macosx_11_0_arm64.whl (1.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

remix_mcp-0.2.0-py3-none-macosx_10_12_x86_64.whl (2.0 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file remix_mcp-0.2.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: remix_mcp-0.2.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for remix_mcp-0.2.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 481474a75c50dbadcfae48a61c9ada50ac6fb7da1d8b458a2fb08bdc1f3a0701
MD5 79f03ba556440521dcb1e0181e70f351
BLAKE2b-256 c9ea2d6deaabd282cd8de2957b6be80d15e1dce7e60810a89a0552969f60a5e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.2.0-py3-none-win_amd64.whl:

Publisher: pypi.yml on christopherwxyz/remix-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file remix_mcp-0.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 24c66c5f068610f00f51fbea7976589839b1b3f88eb7ed8c54b5bf67e26fbadd
MD5 f5360c9a229f20d4cb937695f104f535
BLAKE2b-256 72dcdf0e46ed9b8f5a6da94ad06d15e3e02eb3bbf53a9f88f4ee4ecaf5865c97

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: pypi.yml on christopherwxyz/remix-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file remix_mcp-0.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 8ba1109ef583ae5a80be868594d89d924123ad5b183a173bf4c07f1654672d15
MD5 6f4f5479300ca3113fe5274c02472266
BLAKE2b-256 deeafd0dbbf33fc205d19feb0b656dfce9d20f77f180fbddff8ea588576590d0

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: pypi.yml on christopherwxyz/remix-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file remix_mcp-0.2.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.2.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 16f7f8bf75f09841dbedb70b9440cc3372c1eecc3027e21547321d3ea7721970
MD5 5d201b36c0b138cc6e1f0cfe9a0d4d7b
BLAKE2b-256 aaabb04ec3efaa7f2041b4be0cbb4b8e70017a8171fec5f99d410062cdc2d9db

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.2.0-py3-none-macosx_11_0_arm64.whl:

Publisher: pypi.yml on christopherwxyz/remix-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file remix_mcp-0.2.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.2.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 591ccaeced646ce66d074f7927633c9ae4347da32c66993eefc832ab61dfc5ae
MD5 b928cb23e21cdba4726f44f69d1f810a
BLAKE2b-256 7e66884697d4bbd6a23322e50fb784ad8040221b9a5fa8e69048a2434aee098f

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.2.0-py3-none-macosx_10_12_x86_64.whl:

Publisher: pypi.yml on christopherwxyz/remix-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page