FL Studio MCP

🎼 Overwhelming Developer & Producer Power

The FL Studio MCP (Model Context Protocol) is an open-source bridge that enables AI agents to seamlessly interact with FL Studio. This project exposes 121 distinct tools—ranging from basic transport controls and channel rack sequencing to advanced features like mixing, mastering, arrangement generation, live performance, generative vocals, version control, and extreme AI automation—directly to any MCP-compatible AI (like Claude, Gemini, or custom LLM wrappers).

Whether you're looking to generate complex polyrhythms, optimize harmonic chord voicings, or automate a visual click inside Serum, the FL Studio MCP gives you full, type-safe, dry-run-capable control over your DAW.

Related MCP server: flai-mcp

🛠️ Architecture

The MCP server maintains a persistent, thread-safe, and concurrent-safe connection queue. Below is the simplified message flow between the client, server, and FL Studio instance:

                  ┌──────────────────────────────────────────────┐
                  │          Claude Desktop / MCP Client         │
                  └──────────────────────┬───────────────────────┘
                                         │ stdio (JSON-RPC)
                                         ▼
                  ┌──────────────────────────────────────────────┐
                  │            FL Studio MCP Server              │
                  │              (Python / FastMCP)              │
                  └───────┬──────────────────────────────┬───────┘
                          │                              │
                          ▼ (MIDI SysEx / MMC)           ▼ (OS native script execution)
             ┌─────────────────────────┐    ┌─────────────────────────┐
             │    FLStudioBridge       │    │      GUIAutomation      │
             │  (Lock-guarded I/O)     │    │  (AppleScript/PSh-VBS)  │
             └────┬───────────────▲────┘    └────────────┬────────────┘
                  │               │                      │
                  │ MIDI SysEx    │ Responses            │ Focus / Layout / Mouse Clicks
                  ▼ (IAC/loopMIDI)│ (SysEx)              ▼
             ┌────────────────────┴──────────────────────────────┐
             │                     FL Studio                     │
             │           (FL MCP Bridge script v1.4)             │
             └───────────────────────────────────────────────────┘

The codebase is highly modular and strictly structured:

• src/fl_studio_mcp/server.py: FastMCP server entry point containing tool, resource, and prompt registrations.

• src/fl_studio_mcp/bridge.py: A lock-guarded, concurrent-safe singleton managing the physical MIDI input/output ports and response queries.

• src/fl_studio_mcp/transports/: An abstract transport layer isolating platform specifics. Supports MacOSMIDITransport (IAC Driver), WindowsMIDITransport (loopMIDI), and WebSocketMIDITransport (network-based virtualization).

• src/fl_studio_mcp/automation/: OS-specific scripts (macos.py using AppleScript, windows.py using VBScript + PowerShell) to focus the DAW, click coordinates, reset window layout (Ctrl+Shift+H), and dismiss popup dialogs.

• src/fl_studio_mcp/theory.py: Pure music theory engine containing Euclidean rhythm generators, Markov chain melodies, chord voicing grids, and minimum-transposition voice-leading optimization routines.

• src/fl_studio_mcp/presets.py: A JSON-backed local patch librarian that tracks custom coordinate click coordinates for third-party VSTs.

🧰 The Toolkit (101 Tools)

FL Studio MCP exposes a massively comprehensive suite of 111 distinct tools, broken down by production phase:

1. Connection & Diagnostics (3)

2. Transport, Undo & Latency (6)

3. Realtime Notes & Input (2)

4. Project Operations (1)

5. Status & Channels (4)

6. Patterns & Renaming (5)

7. Pattern Info & Read (3)

8. Mixer Routing & Levels (4)

9. Mixing & Mute/Solo (3)

10. VST Database & File Loader (4)

11. Native OS GUI Automation (3)

12. AI VST Preset Librarian (3)

13. Algorithmic Composition Helpers (3)

14. Super-Producer AI Tools (7)

15. The Autonomous Mix Engineer (8)

🎚️ Phase 10: Mastering & Creative Director

• fl_auto_master – Applies a commercial mastering chain driven to hit a target LUFS (e.g. -14 LUFS).

• fl_eq_reference_match – Analyzes and applies an EQ curve to match the tonal balance of a commercial reference track.

• fl_gross_beat_automator – Automates Gross Beat for instant halftime, tape-stop, and gated FX.

• fl_auto_glitch_chops – Automatically slices and rearranges playlist audio clips for glitch fills.

• fl_audio_to_midi – Extracts harmonic pitch data from audio and converts it to Piano Roll MIDI notes.

• fl_generate_counter_melody – Analyzes a chord progression to generate a complementary counter-melody.

• fl_build_patcher_instrument – Programmatically builds a complex layered instrument using FL Studio's Patcher.

Phase 11: The Executive Producer (Tools 67 - 71)

• fl_vst_parameter_bridge_macro: Create multi-parameter macro knobs for VSTs.

• fl_multi_track_vocal_align: Align multiple vocal dubs/harmonies to a lead vocal track.

• fl_zge_video_wizard: Generate reactive visuals based on track stems using ZGE Visualizer.

• fl_project_version_control: Track and manage multiple versions/mixes of an FLP.

• fl_spatial_audio_panner: Automate Dolby Atmos/Binaural panning for spatial mixing.

Phase 12: The God-Tier Producer (Tools 72 - 81)

• fl_live_performance_mode: Trigger loops and clips in FL's Performance Mode.

• fl_stem_separation_remix: Extract acapella and generate an instrumental remix.

• fl_foley_to_drumkit: Slice foley transients and map them to Slicex.

• fl_vocal_synth_vocodex: Route vocals and synths into Vocodex automatically.

• fl_lyric_to_vocal_take: Generate TTS audio and align it using Pitcher.

• fl_hardware_cv_gate_bridge: Send CV signals to external modular gear.

• fl_advanced_groove_extractor: Extract groove from audio and apply to MIDI.

• fl_cpu_optimizer_bounce: Identify high CPU VSTs and Bounce in Place.

• fl_collaborative_cloud_sync: Package and upload project for remote collaboration.

• fl_industry_metadata_tagger: Embed ISRC codes and ASCAP splits into exported WAV.

Phase 13: The Visionary (Tools 82 - 91)

• fl_neuro_genre_fusion: Mathematically blend properties of two distinct genres.

• fl_ai_session_musician_improviser: Generate humanized 16-bar AI improvised solos.

• fl_dynamic_soundscape_generator: Create generative, multi-layered ambient beds from text.

• fl_vocal_chain_cloner: Clone EQ, compression, and FX chains from a reference acapella.

• fl_film_score_sync: Sync tension strings and impacts to specific video timecodes.

• fl_psychoacoustic_exciter: Maximize perceived loudness via mid-side EQ and phase manipulation.

• fl_auto_foley_foley_designer: Synthesize complex foley sounds from scratch via FM routing.

• fl_adaptive_live_looping: Setup Ableton-style auto-slice live looping with Edison.

• fl_chord_voicing_humanizer: Spread chord voicings and humanize strum velocities.

• fl_project_health_monitor: Background daemon to detect phase issues, CPU spikes, and ear fatigue.

Phase 14: The Architect (Tools 92 - 101)

• fl_macro_arrangement_builder: Place arrangement markers and dummy blocks from structural text.

• fl_vocal_chop_kaleidoscope: Slice transients and generate glitchy, key-locked rhythmic sequences.

• fl_polyphonic_bass_extractor: Extract low-end sub frequencies from complex loops to MIDI.

• fl_auto_gain_staging_assistant: Normalize mixer faders to a pink-noise reference curve (-18dBFS).

• fl_drum_pattern_euclidean: Generate complex polyrhythmic grooves via Euclidean math.

• fl_sidechain_matrix_wizard: Route all bass/synths to a Ghost Kick channel automatically.

• fl_generative_transition_fx: Synthesize risers, sweeps, and drops automatically before song sections.

• fl_hardware_synth_patch_dumper: Bridge SysEx to pull and save patches from external hardware gear.

• fl_plugin_latency_compensator: Auto-detect and fix manual track delays for PDC phase smearing.

• fl_holographic_mixer_ui: Build a Patcher dashboard of the top 10 most-automated project parameters.

Phase 15: The Director (Tools 102 - 111)

• fl_podcast_auto_editor: Detect silence, cross-talk, and apply gating/ducking for broadcast podcasts.

• fl_spectral_morphing_engine: Use Harmor to morph spectral characteristics of two distinct samples.

• fl_automated_remix_contest_parser: Unpack stems, detect key/BPM, and map to Playlist perfectly.

• fl_polyphonic_aftertouch_generator: Generate complex MPE automation data for block chords.

• fl_orchestral_articulation_mapper: Swap orchestral articulations based on MIDI phrasing (via BRSO).

• fl_generative_lyric_video_sync: Map lyric text to vocal transients via ZGameEditor Visualizer.

• fl_master_bus_clipper_optimizer: Mathematically soft-clip master bus to save headroom perfectly.

• fl_lofi_degradation_matrix: Apply automated tape wow, flutter, and vinyl crackle routed via parallel.

• fl_song_structure_mutator: Algorithmic rearrangement of Playlist blocks to IDM/Glitch hop sequence.

• fl_vst_preset_ai_curator: Scan local .fst libraries and NLP tag presets for instant loading.

Phase 16: The Virtuoso (Tools 112 - 121)

• fl_neural_rhythm_quantizer: Extract timing/groove swing and velocity maps from live audio to create custom FL Groove Templates.

• fl_sub_bass_harmonic_synthesizer: Automatically generate matching sub-bass MIDI patterns with custom harmonic saturation.

• fl_dynamic_vocal_rider: Balance vocal levels against instrumental mixes using fine-grained volume automation curves.

• fl_intelligent_transient_splitter: Split audio signals into separate Transient and Sustain channels routed to parallel mixer tracks.

• fl_chord_progression_voicer: Voice MIDI chord progressions automatically using standard keyboard voice-leading rules.

• fl_multiband_stereo_widener_matrix: Split signals into Low (mono), Mid (Haas-widened), and High (delay-widened) frequency bands.

• fl_polyphonic_midi_to_audio_harmonizer: Generate multi-part backing harmonies from vocal audio tracks and MIDI chord patterns.

• fl_resampler_glitch_generator: Bounce playlist regions to audio, load them into Slicex/Granulizer, and randomize parameters for glitch fills.

• fl_intelligent_sidechain_carver: Set up dynamic frequency-specific sidechain ducking centered around target Low bands.

• fl_ai_track_sheet_generator: Auto-scan project layout and compile a professional markdown/HTML tracking sheet.

📦 Installation & Setup

1. Enable loopback MIDI

• macOS (IAC Driver): Open Audio MIDI Setup ➔ MIDI Studio ➔ Double-click IAC Driver ➔ Check "Device is online" ➔ Ensure a bus named "IAC Driver Bus 1" is active.

• Windows (loopMIDI): Install loopMIDI ➔ Create a virtual loopback port named "loopMIDI Port".

2. Sync dependencies

Ensure you have uv installed, then synchronize the environment:

uv sync --all-extras

3. Install the FL Studio Controller Script

Copy the controller script into your local FL Studio hardware settings folder:

# macOS
cp -r fl_studio_scripts/fl_mcp_bridge ~/Documents/Image-Line/FL\ Studio/Settings/Hardware/

# Windows (Command Prompt)
xcopy /E /I fl_studio_scripts\fl_mcp_bridge "%USERPROFILE%\Documents\Image-Line\FL Studio\Settings\Hardware\fl_mcp_bridge"

In FL Studio:

1. Open Options ➔ MIDI Settings.

2. Select your loopback port under Input ➔ Click Enable ➔ Set Controller type to FL MCP Bridge.

3. Select the same port under Output ➔ Click Enable ➔ Match the port index (required for bidirectional queries).

4. Check the FL Studio output log—it will print [FL MCP Bridge v1.4] Initialized.

🌐 WebSocket Network Transport (Hardware-Free Integration)

If you are running FL Studio inside a virtual machine, container, or remote server over a network and do not have access to virtual MIDI cables:

1. Connect the bridge using standard network sockets by specifying a WebSocket URL as the port:

   # Starts a local WebSocket server on port 8765
   uv run fl-studio connect --port "ws://localhost:8765"

2. Your script client in FL Studio can connect to this network bridge. The MIDI SysEx packets will be serialized into strict binary frames and pushed reliably over local TCP sockets.

⌨️ Standalone CLI Interface

The MCP package ships with a Click-powered standalone shell command fl-studio. Port connection preferences are persisted in ~/.fl_studio_mcp.json for seamless command calls:

# List available hardware & virtual MIDI ports
uv run fl-studio ports

# Connect to IAC port
uv run fl-studio connect --port "IAC Driver Bus 1"

# Check DAW live status
uv run fl-studio status

# Perform a tempo change
uv run fl-studio tempo 128

# Control transport
uv run fl-studio play
uv run fl-studio stop

# Channel rack volume & mute
uv run fl-studio channels list
uv run fl-studio channels volume 0 100
uv run fl-studio channels mute 1

# Safe emergency halt
uv run fl-studio panic

🧪 Comprehensive Tests (100% Green)

The server is backed by a massive 337-test suite covering MIDI packet serializations, music theory matrix mathematics, concurrent lock scheduling, mock OS AppleScript/VBScript string matches, and WebSocket network connection lifecycles:

# Run the complete test suite (runs fully in-memory, no hardware required!)
uv run pytest tests/ -v

🚀 Claude Desktop Configuration

Edit your local configuration file ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "fl_studio_mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/FL STUDIO McP",
        "fl-studio-mcp"
      ]
    }
  }
}

Restart Claude Desktop and you'll find the tools active!

📝 Example AI Orchestration Prompts

You can ask your AI assistant to run complete music-making workflows, for example:

1. Generating a Trap Beat Skeleton

"Connect to the MIDI bridge. Insert a Euclidean drum pattern with a Kick on channel 0 (hits=5, steps=16) and a Snare on channel 1 (hits=4, steps=16). Apply 'humanize' velocity modifier."

2. Smooth Voice-Led Progression

"Create a progression in C minor: 'C5-minor, G5-minor, Ab4-major, Bb4-major'. Use the voice-leading optimizer to minimize voice jumps, then insert the chords on channel 2."

3. VST Patch Auditioning

"Focus FL Studio, catalog a new preset click at coordinates X=420, Y=180 named 'Lead Pluck' for Serum, then load the preset automatically."

⚠️ Troubleshooting & Stuck Notes

• Hanging Notes: If a synthesizer rings out indefinitely, run fl_panic immediately. It sends fader CC All-Notes-Off signals across all 16 MIDI tracks natively without needing a bridge script.

• Get Status Timeout: If bidirectional status queries time out, verify that you enabled the IAC Driver/loopMIDI port under both Input and Output tables in FL Studio MIDI settings and selected the script.

Handcrafted for creators, engineers, and AI developers. Keep the beats flowing.