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

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 docs/examples.md 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 CLAUDE.md 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.1.0-py3-none-win_amd64.whl (2.0 MB view details)

Uploaded Python 3Windows x86-64

remix_mcp-0.1.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.1.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.1.0-py3-none-macosx_11_0_arm64.whl (1.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

remix_mcp-0.1.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.1.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: remix_mcp-0.1.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.1.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 e895130a2a23676114167abf2977bb6990ba867d28c9b117e41ec89d4aba5d59
MD5 99258321f1552f170440cfa4717fcad0
BLAKE2b-256 16557fc9c4c557ffac46540bf5d158c89debbca675809dab2d18436d56b7a6da

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.1.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.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 1233fe98732da3b36ba739d0951da04e29e6f05ea8fd9f9e300c0f75d02c2fa7
MD5 94fcdfaaa856c02567f81a06f755b3ad
BLAKE2b-256 b6412dcf6097aaf0da31787b928808d0916dd4b5fdb14783a5e4410ca2dd6096

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.1.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.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 3bfc5e67499580767a93bfb663e8c8221bd1d44d87bae6254d770270afe179d3
MD5 a70e4b359c7ec4ec97b27109aa1e5789
BLAKE2b-256 b24c19f9f329dc479553e7184f83dc1bb6e0afc4dafebb99d0ec32acdd7f93d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.1.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.1.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.1.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 623ebabf933e0af8bb258a27d32ee65df27998a18b5c6218eca83e377fd1fcee
MD5 5e476f83b6873b27994a18f2894815d5
BLAKE2b-256 610bff61d84608f80b4c001386efc0665e4a4ae8a5deb542e6e4319aedbf8589

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.1.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.1.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for remix_mcp-0.1.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 de7f6f62fade0ce96cb337e1707a5854d2be6cf6bb0306e585b279f1485226c2
MD5 00445089710acdf4fdf1293011ea901f
BLAKE2b-256 ef7be3ca077dd08fb78d0cd6410bb6714ed719ad25a552f71d8fc25bac59ea67

See more details on using hashes here.

Provenance

The following attestation bundles were made for remix_mcp-0.1.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