Installation

The fastest install paths are now npm global, the GitHub Release .mcpb, or the Claude Code plugin marketplace. Use source install when developing the repo or testing local changes.

1. Source install

git clone https://github.com/Pantani/ableton-mind.git
cd ableton-mind
npm ci
npm run build
npm run install:remote-script

Then enable AbletonMind in Live:

Live -> Preferences -> Link, Tempo & MIDI -> Control Surface -> AbletonMind.

2. MCP client config

For a local source checkout, point the client at dist/index.js:

{
  "mcpServers": {
    "ableton-mind": {
      "command": "node",
      "args": ["/absolute/path/to/ableton-mind/dist/index.js"]
    }
  }
}

Use the absolute path from your machine.

3. Claude Desktop .mcpb

Download ableton-mind-0.1.1.mcpb from the v0.1.1 GitHub Release, then drag it into Claude Desktop.

The repo can also build a bundle locally:

npm run build:dxt

Drag the generated .mcpb into Claude Desktop.

4. Claude Code plugin marketplace

claude plugin marketplace add Pantani/ableton-mind
claude plugin install ableton-mind@ableton-mind

The plugin starts npx -y ableton-mind@0.1.1. Install and activate the Remote Script in Live before using the MCP tools.

5. npm global

npm install -g ableton-mind
ableton-mind
ableton-mind-doctor

Current registry status: ableton-mind@0.1.1 is published on npm.

6. Docker

Build locally:

docker build -t ableton-mind .
docker run --rm -i --network host ableton-mind

On macOS/Windows Docker Desktop, you may need host.docker.internal for the bridge host:

docker run --rm -it \
  -e ABLETON_MIND_HOST=host.docker.internal \
  ableton-mind

7. Smithery

smithery.yaml is present for the listing path. Hosted Smithery indexing can lag the repository metadata.

Full details in Distribution.