# ableton-mcp

> MCP Server

AbletonMCP integrates Ableton Live with Claude AI via the Model Context Protocol, enabling AI-powered music production, track manipulation, and session control through two-way communication and a socket-based server.

## Overview

- **Category:** AI
- **Language:** Python
- **Stars:** 3010
- **Forks:** 94
- **Owner:** ahujasid
- **GitHub:** https://github.com/ahujasid/ableton-mcp
- **Created:** 2025-03-19T17:00:09+00:00
- **Updated:** 2025-03-28T23:45:50+00:00
- **Source:** https://model-context-protocol.com/servers/ableton-live-claude-ai-music-production

## Setup

## Setup

### Installing via Smithery

To install Ableton Live Integration for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ahujasid/ableton-mcp):

```bash
npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude
```

### Prerequisites

- Ableton Live 10 or newer
- Python 3.8 or newer
- [uv package manager](https://astral.sh/uv)

If you're on Mac, please install uv as:
```
brew install uv
```

Otherwise, install from [uv's official website][https://docs.astral.sh/uv/getting-started/installation/]

⚠️ Do not proceed before installing UV

### Claude for Desktop Integration

[Follow along with the setup instructions video](https://youtu.be/iJWJqyVuPS8)

1.  Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

```json
{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}
```

### Cursor Integration

Run ableton-mcp without installing it permanently through uvx. Go to Cursor Settings > MCP and paste this as a command:

```
uvx ableton-mcp
```

⚠️ Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both

### Installing the Ableton Remote Script

[Follow along with the setup instructions video](https://youtu.be/iJWJqyVuPS8)

1.  Download the `AbletonMCP_Remote_Script/__init__.py` file from this repo
2.  Copy the folder to Ableton's MIDI Remote Scripts directory.
3.  Launch Ableton Live
4.  Go to Settings/Preferences → Link, Tempo & MIDI
5.  In the Control Surface dropdown, select "AbletonMCP"
6.  Set Input and Output to "None"

## Tools

## Available Tools

1.  Two-way communication (Connect Claude AI to Ableton Live through a socket-based server)
2.  Track manipulation (Create, modify, and manipulate MIDI and audio tracks)
3.  Instrument and effect selection (Claude can access and load the right instruments, effects and sounds from Ableton's library)
4.  Clip creation (Create and edit MIDI clips with notes)
5.  Session control (Start and stop playback, fire clips, and control transport)
6.  Get session and track information
7.  Create and modify MIDI and audio tracks
8.  Create, edit, and trigger clips
9.  Control playback
10. Load instruments and effects from Ableton's browser
11. Add notes to MIDI clips
12. Change tempo and other session parameters