Content
# 🎛️ Ableton MCP Server
Control Ableton Live with Claude using the Model Context Protocol.
Built by [Andy Menutti](https://andymenutti.vercel.app) — Creative Technologist / AI Artist / OMNI project.
---
## What it does
Connects Claude Desktop to Ableton Live 12 via WebSocket, letting you control your DAW with natural language:
- Get session info (tempo, tracks, time signature)
- Set tempo, volume, panning per track
- Mute / Solo tracks
- Play / Stop transport
- Inspect devices on any track
- Apply **OMNI patch** — loads EQ Eight + Compressor on all tracks at once
---
## Requirements
- Ableton Live 11 or 12
- Node.js 18+
- Claude Desktop
---
## Setup
### 1. Install AbletonJS Remote Script
**macOS (Live 12):**
```bash
cp -r AbletonMCP_Remote_Script "/Applications/Ableton Live 12.app/Contents/App-Resources/MIDI Remote Scripts/AbletonMCP"
```
Then in Ableton → Preferences → MIDI → Control Surface → select **AbletonMCP**.
### 2. Build the server
```bash
npm install
npm run build
```
### 3. Configure Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"ableton-mcp": {
"command": "node",
"args": ["/absolute/path/to/ableton-mcp/dist/index.js"]
}
}
}
```
Restart Claude Desktop.
---
## Usage
> *"What tracks are in my session?"*
> *"Set the tempo to 120 BPM"*
> *"Mute track 3"*
> *"Apply the OMNI patch to all tracks"*
> *"What devices are on track 0?"*
---
## OMNI patch
The `omni_patch` tool loads **EQ Eight + Compressor** on every track in one command — a starting point for mix treatment across the full session.
---
## Project
Part of [OMNI](https://andymenutti.vercel.app) — an AI art project exploring listening, space, and generative sound.
Selected among 300 from 32,000 applicants — Buildspace / a16z / YCombinator program.
---
## License
MIT
EOF
```