MCP Directory

How to add AbletonMCP to Windsurf

Connect Claude to Ableton Live — create tracks, write MIDI clips, load instruments, and build full arrangements. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 2.8k★ · stdio · no auth

Windsurf config for AbletonMCP

uvx ableton-mcp
{
  "mcpServers": {
    "abletonmcp": {
      "command": "uvx",
      "args": [
        "ableton-mcp"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the AbletonMCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5AbletonMCP's tools become available to Cascade.

Before you start

  • Ableton Live 10 or newer
  • Python 3.8+ and the uv package manager (brew install uv on macOS — install uv before anything else)
  • The AbletonMCP Remote Script copied into Ableton's MIDI Remote Scripts directory and selected as a Control Surface

What AbletonMCP can do in Windsurf

get_session_info

Get details about the current Ableton session

get_track_info

Get details about a specific track

create_midi_track

Create a new MIDI track

set_track_name

Rename a track

create_clip

Create a new MIDI clip in a track slot

create_audio_clip

Create an audio clip

add_notes_to_clip

Add MIDI notes to a clip

set_clip_name

Rename a clip

Security

The server directly controls your live Ableton session — it can create and modify tracks, load devices, and change tempo immediately, so save your project before letting an agent experiment. It's third-party (not affiliated with Ableton) and sends anonymous usage telemetry unless you set ABLETON_MCP_DISABLE_TELEMETRY=true; the project says no audio, project names, or personal data are collected.

AbletonMCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the AbletonMCP config there under the "mcpServers" key and restart the client.

Is AbletonMCP safe to use with Windsurf?

The server directly controls your live Ableton session — it can create and modify tracks, load devices, and change tempo immediately, so save your project before letting an agent experiment. It's third-party (not affiliated with Ableton) and sends anonymous usage telemetry unless you set ABLETON_MCP_DISABLE_TELEMETRY=true; the project says no audio, project names, or personal data are collected.

Is AbletonMCP free and safe for my projects?

Free and MIT-licensed, but it edits your live session in real time — track creation, device loading, and tempo changes apply immediately, so save first and lean on undo. It also collects anonymous telemetry by default; opt out with ABLETON_MCP_DISABLE_TELEMETRY=true in the server's env.

Is this made by Ableton?

No — it's a third-party community integration by Siddharth Ahuja, and the README carries an explicit disclaimer that it is not made by Ableton. Ableton Live 10+ is required but no Ableton partnership is involved.

Claude can't see my Ableton session — what's wrong?

Usually one of three things: the Remote Script isn't loaded (Control Surface must be set to AbletonMCP), two MCP server instances are running (use Cursor or Claude Desktop, not both), or the apps need a restart. The connection establishes automatically once the Remote Script and server are both up.

View repo Full AbletonMCP page