Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Ableton MCP Create a 4-bar trap beat and a dark chord progression in C minor"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🌐 English | 日本語
An AI agent that gives you full control over Ableton Live using natural language.
Use directly from Claude Desktop. Control Ableton just by chatting - no API key needed.
Operate from terminal using your Anthropic API key.
⚠️ Note: CLI mode is experimental and has not been fully tested.
Related MCP server: AbletonMCP
cd ableton-mcp
pip install -e .Edit the Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ableton-mcp": {
"command": "python",
"args": ["-m", "src.mcp_server"],
"cwd": "/path/to/ableton-mcp"
}
}
}⚠️ Replace cwd with the actual path to your ableton-mcp folder.
📖 Windows users: See INSTALL_WINDOWS.md for detailed instructions.
Option A: Max for Live Device (Simple)
Download AbletonOSC
Drag AbletonOSC.amxd onto a track in Ableton Live
Option B: Remote Script (Recommended)
Download from https://github.com/ideoforms/AbletonOSC
Place in Remote Scripts folder:
Windows: C:\Users\<YourName>\Documents\Ableton\User Library\Remote Scripts\AbletonOSC
macOS: ~/Music/Ableton/User Library/Remote Scripts/AbletonOSC
Folder structure: AbletonOSC\__init__.py should be directly inside
In Ableton Live → Preferences → Link/Tempo/MIDI → Control Surface → Select AbletonOSC
After restarting, you can control Ableton directly through chat!
You: Create a 4-minute EDM track
Claude: [using generate_arrangement tool]
Generated arrangement...
You: Add trap-style drums
Claude: [using create_drum_track tool]
Created drum track 'Drums'...Basic beats, four-on-floor, trap, breakbeat, D&B
Custom pattern creation
Melody: Scale-based auto-generation (adjustable density and contour)
Basslines: basic, walking, syncopated, octave, arpeggiated
Chord progressions: pop, jazz, sad, epic, dark, edm, lofi, cinematic
Arpeggios: up, down, updown, random (8th/16th/triplet)
Local library search (Ableton Core Library, Splice, etc.)
Freesound API support
Natural language queries
Frequency collision detection (kick vs bass, etc.)
Automatic sidechain compression setup
EQ suggestions
Level/dynamics analysis
Genre templates: EDM, House, Techno, D&B, HipHop, Trap, Lo-Fi, Ambient, Pop
Complete structure: Intro → Buildup → Drop → Breakdown → Outro
Automatic automation generation
# Ableton connection mode
python src/cli.py
# Mock mode (test without Ableton)
python src/cli.py --mock╔════════════════════════════════════════════════════════════════╗
║ 🎹 Ableton Agent CLI v2.0 🎹 ║
╚════════════════════════════════════════════════════════════════╝
🎤 You: Create a 4-minute EDM track
🤖 Agent: I'll generate an EDM track arrangement.
🎛️ Executing: generate_arrangement
Parameters: {"genre": "edm", "duration_minutes": 4.0}
✅ Generated arrangement:
🎵 Untitled Edm
Tempo: 128 BPM | Key: Am
Total: 72 bars
📋 Structure:
[ 0] intro | 8 bars | Energy: ███░░░░░░░
[ 8] buildup | 8 bars | Energy: █████░░░░░
[ 16] drop | 16 bars | Energy: ██████████
[ 32] breakdown | 8 bars | Energy: ████░░░░░░
[ 40] buildup | 8 bars | Energy: ███████░░░
[ 48] drop | 16 bars | Energy: ██████████
[ 64] outro | 8 bars | Energy: ███░░░░░░░
🎤 You: Create trap-style drums
🤖 Agent: I'll create a trap-style drum pattern.
🎛️ Executing: create_drum_track
Parameters: {"pattern_type": "trap", "bars": 2, "name": "Trap Drums"}
✅ Created drum track 'Trap Drums' (pattern: trap, 2 bars)Command | Description |
| Show help |
| Show project status |
| List available genres |
| Show current arrangement |
| Toggle mock mode |
| Clear conversation history |
| Exit |
"Create a basic drum pattern"
"Make a 4-bar trap beat"
"Four on the floor kick"
"Create a breakbeat"
"Create a melody in C minor"
"Bright pentatonic melody"
"Syncopated bassline"
"Add an octave bass"
"16th note arpeggio"
"Create a dark chord progression"
"Jazzy chords"
"Cinematic chord progression"
"Search for ethnic percussion"
"Dark synth 140BPM"
"Find kick samples"
"Analyze the mix"
"Kick and bass are clashing"
"It sounds muddy"
"Set up sidechain"
"Add reverb"
"Create a 4-minute EDM track"
"Generate a lo-fi hip hop structure"
"Make a techno arrangement"
"Make it darker"
"Brighten it up"
"Make it more intense"
"Chill vibe"
ableton-mcp/
├── .gitignore
├── LICENSE
├── README.md # English
├── README.ja.md # Japanese
├── INSTALL_WINDOWS.md # Windows setup guide
├── pyproject.toml
├── setup.bat # Windows setup script
├── claude_desktop_config.example.json # Example config
└── src/
├── __init__.py
├── mcp_server.py # MCP server (for Claude Desktop)
├── cli.py # CLI interface
├── agent.py # AI agent (Claude API)
├── ableton_osc.py # Ableton OSC communication
├── synth_generator.py # Melody/bass/chord/arpeggio generation
├── sample_search.py # Sample search engine
├── mixing_assistant.py # Mixing analysis & assistance
└── arrangement_generator.py # Song structure generationAdd tool definition to ABLETON_TOOLS in src/agent.py:
{
"name": "your_tool_name",
"description": "Tool description",
"input_schema": {
"type": "object",
"properties": {
"param1": {"type": "string", "description": "Description"}
},
"required": ["param1"]
}
}Add execution logic to execute_command in src/cli.py:
elif tool == "your_tool_name":
return self._your_implementation(params)Add to GenreTemplates.TEMPLATES in src/arrangement_generator.py:
"your_genre": {
"sections": [
("intro", 8, 0.3, ["pad"]),
("verse", 16, 0.6, ["drums", "bass"]),
# ...
],
"tempo_range": (100, 120),
"default_key": "Am",
}┌─────────────────────────────────────────────────────────────────┐
│ User Input (Natural Language) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Claude API (Tool Use) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Drums │ │ Melody │ │ Samples │ │ Mixing │ ... │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Command Executor │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ SynthGenerator │ │ SampleSearch │ │ MixingAssist │ │
│ └────────────────┘ └────────────────┘ └────────────────┘ │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ ArrangementGen │ │ DrumPattern │ │
│ └────────────────┘ └────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ OSC Communication │
│ (python-osc) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Ableton Live │
│ (via AbletonOSC) │
└─────────────────────────────────────────────────────────────────┘Start Ableton Live first
Confirm AbletonOSC shows "Started AbletonOSC on address ('0.0.0.0', 11000)" in log
Then start Claude Desktop
Check that AbletonOSC is loaded
Verify port 11000 is available
Check firewall settings
Windows - Check ports:
netstat -ano | findstr "11000 11001"Windows - Check Ableton log:
Get-Content "$env:USERPROFILE\AppData\Roaming\Ableton\Live *\Preferences\Log.txt" -Tail 50 | Select-String "OSC"After editing files: Restart Claude Desktop completely (exit from system tray)
Connection problems: Restart Claude Desktop
Verify ANTHROPIC_API_KEY is correctly set
Check API usage limits
Check sample folder paths
Specify custom paths when initializing SampleSearchEngine
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
MCP server for Producer/Riffusion AI music generation
Generate AI images, video, speech, music and presentations from Claude, ChatGPT and Cursor.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/keigotak/AbletonMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server