Skip to content
Install
mcp-registry/AbletonMCP (Ableton Live MCP Server)
AbletonMCP (Ableton Live MCP Server) logo

AbletonMCP (Ableton Live MCP Server)

Author: ahujasid

Description: MCP (Model Context Protocol) server + Ableton Live Remote Script that lets MCP clients (Claude Desktop / Cursor) control Ableton Live via a JSON-over-TCP socket bridge. Enables session/track inspection, track and clip creation/editing, device (instruments/effects) loading from Ableton’s browser, transport/playback control, tempo changes, and MIDI note insertion.

Stars: 2.3k

Forks: 281

License: MIT License

Category: Specialized

Overview

Installation

## Installing via Smithery (Claude Desktop)
1. Install Ableton Live Integration for Claude Desktop via Smithery:
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](https://astral.sh/uv)
If you're on Mac, install uv as:
brew install uv
Otherwise, install uv from: [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/)
## Claude for Desktop integration
1. Open: Claude > Settings > Developer > Edit Config > `claude_desktop_config.json`
2. Add the MCP server configuration:
{ "mcpServers": { "AbletonMCP": { "command": "uvx", "args": ["ableton-mcp"] } } }
## Cursor integration
In Cursor Settings > MCP, use this command:
uvx ableton-mcp
Note: Only run one instance of the MCP server (either Cursor or Claude Desktop), not both.
## Installing the Ableton Remote Script
1. Download the `AbletonMCP_Remote_Script/__init__.py` file from this repo.
2. Copy the folder to Ableton's MIDI Remote Scripts directory (locations vary by OS/version):
macOS:
- Applications > Right-click Ableton Live app → Show Package Contents → `Contents/App-Resources/MIDI Remote Scripts/`
- Or: `/Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts`
Windows:
- `C:\Users[Username]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts`
- `C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\`
- `C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\`
(Replace `XX` with your Ableton version number.)
3. Create a folder called `AbletonMCP` in the Remote Scripts directory and place the downloaded `__init__.py` inside it.
4. Launch Ableton Live.
5. Go to Settings/Preferences → Link, Tempo & MIDI.
6. In the Control Surface dropdown, select `AbletonMCP`.
7. Set Input and Output to `None`.
## Usage (starting the connection)
1. Ensure the Ableton Remote Script is loaded in Ableton Live.
2. Ensure the MCP server is configured in Claude Desktop or Cursor.
3. The connection should establish automatically when you interact with Claude.

FAQs

How do I troubleshoot connection issues between the AbletonMCP server and the Remote Script on localhost:9877?

Check that Ableton's Control Surface is set to AbletonMCP in Preferences → MIDI. Verify the Remote Script loaded by checking Ableton's logs. Test port 9877 availability using netstat or lsof to confirm no other process is blocking it. Restart both Ableton and the MCP client after configuration changes, as the socket connection initializes when Ableton launches the Remote Script.

What specific Ableton Live API actions can AbletonMCP perform through natural language commands?

AbletonMCP translates natural language into Live API actions including creating tracks, writing MIDI clips with specific note patterns, loading devices from the browser, adjusting session tempo, controlling transport playback, applying effects like reverb, modifying note velocities for humanization, merging clips, and duplicating patterns across tracks. These operations execute through the Remote Script's access to Live's internal Python API.

Can I modify the AbletonMCP Remote Script to use a different TCP port than 9877?

Yes, modify the Remote Script's __init__.py file to change the hardcoded port from 9877 to your preferred port. You must also update the MCP server configuration to match. Ensure both components use identical port values. Non-standard ports may complicate troubleshooting since community support assumes the default 9877 configuration.

What are the latency and stability limitations of using AbletonMCP for real-time mixing during a live performance?

Real-time latency depends on your Python runtime overhead, local network stack performance, and Ableton's Remote Script thread priority. Stability is constrained by TCP's reconnection behavior, lack of error recovery in the single-threaded socket listener, and Python's garbage collection pauses. Test under load with concurrent parameter automation to measure actual jitter before deploying live.

Can MCP servers be integrated with other AI frameworks like TensorFlow or PyTorch?

Yes, MCP servers integrate with TensorFlow or PyTorch indirectly through agent frameworks like LangChain, LlamaIndex, or CrewAI. These frameworks use the models for inference or tool execution while MCP handles agent-to-tool communication. Build custom MCP servers to expose TensorFlow or PyTorch models as callable tools, or containerize model endpoints that MCP-compatible agents can discover and invoke at runtime.

How does MCP compare to traditional API gateways?

MCP is an AI-native bidirectional protocol enabling agents to dynamically discover tools via JSON-RPC, optimizing stateful interactions and reducing development effort through automatic capability querying. Traditional API gateways route stateless HTTP traffic with manual configuration, excelling in low-latency transactions but lacking native context retention or tool auto-discovery. Choose MCP for multi-agent ecosystems; use gateways for transactional applications.

License: MIT License
Updated 1/28/2026