FL Studio MCP

An MCP server that lets AI assistants
control FL Studio fully — transport, mixer, channel rack, plugins,
patterns, step sequencer, piano roll, and the entire FL scripting API —
over a virtual MIDI trigger + JSON command channel.

Version 1.1.1 · MIT License · © 2026 Ziad Salah (Zierax)

Why this exists

FL Studio's scripting API is powerful but unreachable from Python. This
project bridges the gap:

MCP client (Claude, Cursor, ...)
        │  stdio (JSON-RPC)
        ▼
   FastMCP server (Python)          ── the 164 tools
        │  writes mcp_command.json + triggers MIDI note 127
        ▼
   FL Studio controller script      ── runs INSIDE FL Studio,
        │  executes the FL scripting API, writes mcp_response.json
        ▼
   FL Studio project                ── the DAW itself

Features

Area	Capabilities
Transport	Play, stop, record, song position/length, loop mode, playback speed, tempo, shuffle
Mixer	Volume, pan, mute, solo, arm, name, color, stereo separation; routing, sends, EQ, FX slots, peaks
Channel rack	List/inspect/select channels, live note triggering, volume/pan/mute/solo/name/color, pitch, step sequences, shuffle
Patterns	Create, list, select, rename, clone, clear, set length
Plugins	Name, parameter list/get/set, presets, colors
Step sequencer	Read/write/clear step patterns with per-step pitch, velocity, pan
Piano roll	Add notes/chords (exact timing), delete, clear, read state
Playlist	Track names, colors, mute/solo/select, full playlist state
Advanced	Raw access to every function of every FL API module, undo history, project info, markers, device info, UI automation hints

Requirements

FL Studio 20.7+ on Windows or macOS (tested on FL Studio 2025 / Windows)
Python 3.10+
uv (recommended package manager)
A virtual MIDI port:
- Windows: loopMIDI
- macOS: IAC Driver (enable it in Audio MIDI Setup)

Quick start

1. Install the controller script in FL Studio

Run the installer, or copy fl_controller/device_FLStudioMCP.py manually (see
docs/SETUP.md for both options):

# Windows (PowerShell)
.\install.ps1

# macOS / Linux
./install.sh

2. Point FL Studio at the script

Restart FL Studio (or press Options → Update MIDI scripts).
Options → MIDI Settings → under Input, select your virtual port
(e.g. FLStudioMCP 1).
Set its Controller type to FL Studio MCP Controller and enable the
port.

3. Connect the server

{
  "mcpServers": {
    "fl-studio": {
      "command": "uv",
      "args": ["run", "--directory", "D:\\Axioms\\FL-MCP", "fl-studio-mcp"]
    }
  }
}

Adjust --directory to your clone (or /path/to/FL-MCP on macOS/Linux).
The server is a standard stdio MCP server — any MCP client can use it.

Then talk to it in natural language:

"Connect to FL Studio, set the tempo to 140 BPM and create a pattern named 'Drop'."

"Program a kick on steps 0, 4, 8, 12 of channel 0 and a snare on steps 4 and 12 of channel 1."

"Set mixer track 3 volume to 80%, pan it slightly left, and solo track 1."

Documentation

Everything lives in docs/:

Document	Contents
docs/SETUP.md	Full installation: Windows, macOS, manual vs installer, first run
docs/TOOLS.md	The complete tool catalog with arguments and examples
docs/ARCHITECTURE.md	How the MIDI + JSON bridge and hot-reload work
docs/TROUBLESHOOTING.md	Fixes for the problems people actually hit
docs/LIMITATIONS.md	What the FL Studio API can and cannot do
docs/DEVELOPMENT.md	Adding tools, versioning, releasing
docs/MENTION.md	Credits and backbone projects

Known limitations (summary)

The FL Studio scripting API cannot create channels or load audio files —
the server controls whatever already exists in the project.
Playlist clips cannot be placed programmatically — pattern management is
fully automated, arranging on the timeline is not.
Live-triggered notes are not persisted unless recording is on; for written
music use the step sequencer or piano roll tools.

Full details: docs/LIMITATIONS.md.

Project layout

fl_controller/
  device_FLStudioMCP.py   ← the script that runs inside FL Studio (hot-reloadable)
src/fl_studio_mcp/
  server.py               ← MCP entry point + connection tools
  utils/                  ← MIDI trigger, JSON command channel, connection
  tools/                  ← 9 tool groups: transport, mixer, channels, patterns,
                             plugins, sequencer, piano_roll, advanced, fullcontrol
scripts/                  ← installer helpers (.pyscript legacy, .ps1/.sh)
docs/                     ← this documentation
install.ps1 / install.sh  ← one-command installers

Credits

Built on the backbone of
karl-andres/fl-studio-mcp
(piano roll integration inspired by
calvinw/fl-studio-mcp). FL API
reference: IL-Group/FL-Studio-API-Stubs.
See docs/MENTION.md.

License

MIT — see LICENSE.