Repository navigation
Releases
Releases Β· teamallnighter/ableton-cookbook-mcp
AI Gateway M4L Device v1.0.0
Initial release of the AI Gateway Max for Live device.
Features
- Real-time LOM (Live Object Model) access via UDP bridge
- Claude can read/write MIDI, control devices, query session data
- Status LED indicator (green = connected)
- Activity counter showing requests processed
- Error display for debugging
- Start/Stop toggle for the UDP server
Installation
The Ableton Cookbook installer will download and install this automatically to:
~/Music/Ableton/User Library/Presets/Audio Effects/Max Audio Effect/AI Gateway/
Usage
- Drag AI Gateway onto any track in Ableton Live
- Click Start to begin the UDP server
- Claude can now access your session via the LOM tools
Requirements
- Ableton Live 11+ with Max for Live
- Ableton Cookbook MCP server running
Ableton Cookbook v0.2.0 - Unified App
π Ableton Cookbook v0.2.0 - Unified App
Major Update: Installer and Menu Bar app are now unified into one seamless experience!
β¨ What's New
Smart Launch Behavior
- First launch: Shows setup wizard to configure Claude Desktop
- Subsequent launches: Opens directly in menu bar mode
- No confusion, no mysterious app installations
Unified Experience
- One app in
/Applicationsinstead of two - Automatic transition from setup β menu bar
- "Run Setup Again" menu option for reconfiguration
ποΈ Menu Bar Features
- π§ Kill Port 39031 - Clear stuck MCP server processes
- π Test Connection - Verify Claude Desktop and port status
- βοΈ Run Setup Again - Reopen setup wizard anytime
- π Launch at Login - Start automatically on system boot
- Quit - Clean shutdown
π Upgrading from v0.1.2
Simply install v0.2.0 over your existing installation. The app will detect your existing configuration and go straight to menu bar mode.
π¦ Installation
- Download the DMG
- Open and drag "Ableton Cookbook" to Applications
- Launch - setup wizard appears on first run
- Complete setup and the app transitions to menu bar mode
Full Changelog:
- Merged desktop installer and menu bar app into unified experience
- Added smart launcher with setup completion detection
- Integrated "Run Setup Again" functionality
- Added "Launch at Login" toggle
- Improved user experience with single app installation
- Code signed and notarized for macOS
Ableton Cookbook v0.1.2 - Signed & Notarized
Production Release - Signed & Notarized
This release features a fully signed and notarized macOS installer.
Bug Fixes
- Fixed installer hanging on Claude Desktop detection step
- Fixed npm detection for installations using nvm
- Improved installer reliability across different system configurations
Security
- Code Signed with Apple Developer ID Certificate
- Notarized by Apple (malware scanned and approved)
- Zero security warnings on macOS
Installation
- macOS (Apple Silicon): Download Ableton Cookbook-0.1.2-arm64.dmg
- No right-click workaround needed - double-click to install!
Requirements
Requires ableton-cookbook-mcp v0.1.4 or later
Full Changelog: v0.1.0...v0.1.2
Ableton Cookbook v0.1.0
π Initial Release - Desktop Installer
What's New
Desktop Application
- 5-Step Setup Wizard for non-technical users
- Auto-Detection of Ableton Live installation paths
- Auto-Detection of Claude Desktop configuration
- One-Click MCP Installation via npm
- Automatic Configuration writing to Claude config
- Brand Colors Applied: Gray (#A8A8A8), Golden (#F1AC00), Dark (#424040), Light (#C8C8C8)
- Custom Icons for macOS and Windows
MCP Server Features
- ποΈ Archivist Module: Offline project parsing and analysis
- ποΈ Operator Module: Live control and real-time interaction
- π Historian Module: Git-based version control for projects
- π¬ Analyzer Module: Deep analysis of racks, presets, and drum racks
- 16 Total Tools for comprehensive Ableton Live integration
Distribution Options
- π¦ macOS DMG Installer (ARM64)
- π¦ macOS ZIP Archive (ARM64)
- π¦ Windows NSIS Installer (ARM64)
- π¦ npm Package:
npm install -g ableton-cookbook-mcp
Installation
Desktop Installer (Recommended for Non-Technical Users)
- Download the installer for your platform below
- Run the installer and follow the 5-step wizard
- Everything is configured automatically!
npm (For Developers)
npm install -g ableton-cookbook-mcpRequirements
- Ableton Live 10, 11, or 12
- Claude Desktop
- Node.js 18+ (auto-installed by desktop app)
Links
- π¦ npm Package
- π Documentation
- π Report Issues