Skip to main content
Glama
README.md
<div align="center">

# Ableton MCP · 21 Academy

**Conecta Ableton Live con Claude para automatizar el trabajo repetitivo del estudio.**

La IA organiza, rutea y prepara tu sesión. La música la haces tú.

</div>

---

## ¿Qué es esto?

Una versión ampliada de [AbletonMCP](https://github.com/ahujasid/ableton-mcp) (de Siddharth Ahuja, licencia MIT) mantenida por Franco / 21 Academy. Le agrega lo que un productor necesita para **organizar una sesión** sin hacerlo a mano:

| Herramienta nueva | Qué hace |
|---|---|
| `get_tracks_overview` | Lista todas las pistas con su color, grupo, salida, volumen, paneo, mute y solo, en una sola llamada |
| `set_track_color` | Colorea una pista (hex `#RRGGBB` o nombre: `rojo`, `azul`, `red`, `blue`…) |
| `set_track_output_routing` / `get_track_output_routing` | Cambia o consulta a dónde va el audio de una pista (Main, un bus, Group…) |
| `set_track_volume` | Mueve el fader a un valor en dB (por ejemplo `-6`) |
| `set_track_pan` | Paneo de -1 (izquierda) a 1 (derecha) |
| `set_track_mute` / `set_track_solo` | Mute y solo |
| `configure_tracks` | Aplica nombre, color, salida, volumen, paneo, mute y solo a **muchas pistas en una sola llamada** (más rápido y más barato) |

Todas funcionan en pistas normales, returns y el master (`track_type`: `track`, `return` o `master`).

**Lo que no puede hacer:** agrupar pistas. La API de Ableton no lo permite desde scripts. La solución es trabajar con una plantilla que ya tenga los grupos armados.

**Privacidad:** a diferencia del original, aquí la telemetría viene **apagada por defecto**. No se envía nada a ningún servidor.

---

## Instalación (macOS)

**1. Instala `uv`** (en Terminal):

```bash
brew install uv
```

**2. Instala el Remote Script en Ableton:**

```bash
uvx --from git+https://github.com/francocesti21/ableton-mcp-21 ableton-mcp-install-script
```

Si ya tenías el AbletonMCP original, se reemplaza (el anterior queda respaldado como `__init__.py.bak`).

**3. Agrégalo a Claude:** Claude → Settings → Developer → Edit Config, y dentro de `"mcpServers"`:

```json
"AbletonMCP": {
  "command": "uvx",
  "args": ["--from", "git+https://github.com/francocesti21/ableton-mcp-21", "ableton-mcp"]
}
```

Guarda y cierra Claude por completo (Cmd+Q). Vuelve a abrirlo.

**4. Actívalo en Ableton:** Settings → Link, Tempo & MIDI → Control Surface: **AbletonMCP**, Input y Output en **None**. Si Ableton estaba abierto al instalar, reinícialo.

---

## Ejemplos de pedidos

- *"Muéstrame cómo está organizada la sesión."*
- *"Colorea en rojo todas las pistas de batería y mándalas al grupo DRUMS."*
- *"Pon todas las pistas a -6 dB de partida."*
- *"Mutea las pistas que se llamen COPIA."*

---

## Desarrollo

```bash
uv run --with pytest pytest -q
```

Las pruebas simulan la API de Ableton, así que no hace falta tener Live abierto.

## Créditos y licencia

Basado en [ahujasid/ableton-mcp](https://github.com/ahujasid/ableton-mcp) (MIT). La documentación original está en [README_UPSTREAM.md](README_UPSTREAM.md). Este proyecto mantiene la licencia MIT.

TDQS

B3.3/5.0

Scored across 46 tools

Disambiguation4/5

Most tools map cleanly to a distinct resource+action (create_midi_track vs create_audio_track, set_clip_name vs set_arrangement_clip_name) and descriptions explicitly disambiguate. The main soft spots are four overlapping read tools (get_session_info, get_session_snapshot, get_tracks_overview, get_track_info), the per-setting set_track_* calls versus the bulk configure_tracks, and fire_clip versus start_playback.

Naming Consistency4/5

Nearly everything is snake_case with a verb-first pattern (get_*, set_*, create_*, load_*, stop_*, record_*). A few read as noun-first or awkward (fire_clip, switch_to_arrangement_view) and the telemetry tools use a slightly different imperative vocabulary, but the convention is readable and predictable overall.

Tool Count2/5

46 tools is heavy even for a DAW bridge. The six individual track setters (name, color, volume, pan, mute, solo) are all subsumed by configure_tracks, and six further tools are telemetry/preference logging (submit_intent, rate_last_action, prefer_candidate, reject_last_action, record_audition, set_dataset_consent) that sit outside the musical editing surface.

Completeness3/5

Core workflows are well covered: session reading, track creation, clip lifecycle, notes read/modify/write, device loading and parameters, browser browsing, transport, tempo, arrangement and locators. Notable gaps remain — no delete_track, no return/group track creation, no device or parameter reset/removal, no send-level control, and no way to list a track's devices.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues