Ableton Live + Claude Desktop App: Complete MCP Integration

Ableton Live is a MCP server that an MCP server to control Ableton Live..

When integrated with Claude Desktop App, you can:

• Create, modify, and control audio/MIDI tracks
• Control live performance parameters and session view
• Send and receive OSC messages for real-time control

This guide provides step-by-step instructions to set up Ableton Live in Claude Desktop App, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

• Ableton Live will be fully integrated and operational
• You can use Ableton Live tools directly in Claude Desktop App
• All Ableton Live capabilities will be available for your workflows
• Access to 4 different tools

Prerequisites

Before starting, ensure you have:

• Python 3.8+
• Git
• Ableton Live installed
• Claude Desktop App installed and configured
• Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Ableton Live

Manual installation steps:

1. Install Python 3.8 or higher
2. Install uv package manager
3. Clone repository: git clone https://github.com/Simon-Kansara/ableton-live-mcp-server.git
4. Navigate to project: cd mcp_ableton_server
5. Install dependencies: uv sync

Configuration

Step 2: Configure Claude Desktop App

1. Locate your configuration file:

   • Windows: %APPDATA%\\Claude\\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add server configuration:

{
  "mcpServers": {
    "ableton-live": {
      "command": "ableton live",
      "args": [""],
      "env": {
        
      }
    }
  }
}

3. Restart Claude Desktop App

Completely quit and restart Claude Desktop App to load the new configuration.

Examples

Once configured, you can use Ableton Live in Claude Desktop App:

Prepare Recording Setup

Set up tracks for recording a rock band

Ask Claude Desktop App: "Prepare a set to record a rock band with drums, bass, guitar, and vocals"

Expected Result: Multiple audio tracks created with appropriate input routing and naming

Configure Voice Track Routing

Set input routing for vocal tracks

Ask Claude Desktop App: "Set the input routing channel of all tracks that have "voice" in their name to Ext. In 2"

Expected Result: All vocal tracks configured to receive input from external input 2

Live Performance Setup

Configure session view for live performance

Ask Claude Desktop App: "Set up a live performance session with 8 tracks and 16 scenes for electronic music"

Expected Result: Session view configured with tracks and scenes ready for live triggering

Transport Control

Control playback and recording

Ask Claude Desktop App: "Start recording on track 3 and set tempo to 120 BPM"

Expected Result: Recording initiated on specified track with tempo adjusted

Testing Your Setup

1. Start a new conversation in Claude Desktop App
2. Ask Claude Desktop App to list available tools
3. Try using Ableton Live functionality

Test prompts:

• "Can you list the available tools from Ableton Live?"
• "Please use Ableton Live to {example_task}"

Troubleshooting

Common Issues

Ableton Live Not Responding

Symptoms: OSC messages not received, No communication with Live

Cause: OSC control surface not enabled or incorrect port configuration

Solution:

• Enable AbletonOSC control surface in Live preferences
• Verify OSC ports match configuration (11000/11001)
• Restart Ableton Live after configuration changes
• Check firewall settings allow OSC communication

Port Already in Use

Symptoms: Socket binding errors, Port conflict messages

Cause: Another application using configured ports

Solution:

• Check which process is using the port: netstat -tulpn | grep :65432
• Kill conflicting process or change port in osc_daemon.py
• Use alternative ports (e.g., 65433, 11002, 11003)
• Restart both server and Ableton Live

Python Dependencies Missing

Symptoms: Import errors, Module not found errors

Cause: Required packages not installed properly

Solution:

• Run uv sync to install all dependencies
• Verify Python 3.8+ is installed: python --version
• Check virtual environment is activated
• Install missing packages manually: pip install python-osc fastmcp

OSC Messages Not Routing

Symptoms: Commands not affecting Live, No response from controls

Cause: Incorrect OSC routing or message format

Solution:

• Verify OSC address patterns match Live expectations
• Check OSC message format and data types
• Test basic OSC connectivity with simple messages
• Review osc_daemon.py configuration for routing rules

Server Not Appearing

Symptoms: No server in interface, Tools not available

Cause: Configuration file error or server installation issue

Solution:

• Validate JSON syntax using online validator
• Check configuration file location
• Verify server installation
• Restart Claude Desktop completely

Server Error on Startup

Symptoms: Error messages in logs, Server fails to start

Cause: Missing dependencies or environment variables

Solution:

• Check server requirements are met
• Verify environment variables are set
• Check system logs for detailed errors

Ableton Live not appearing in Claude Desktop App

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

• Verify configuration syntax
• Check Ableton Live installation
• Restart Claude Desktop App
• Check logs for error messages

Next Steps

Now that Ableton Live is integrated with Claude Desktop App:

• Explore all Ableton Live capabilities through Claude Desktop App
• Check out other MCP servers that work with Claude Desktop App
• Join the MCP community for tips and support
• Consider contributing to Ableton Live development

Need Help?

• Search for Ableton Live documentation
• Check the Claude Desktop App MCP guide
• Join the MCP community discussions