Skip to main content
Glama
FL Studio MCP

FL Studio MCP

by Caelvoryn

FL Studio MCP 1.2.0.dev3 — UI-first development preview

See the current release review and the historical dev2 GUI acceptance matrix for tested layouts and limits.

The dev3 preview upgrades FastMCP. The audited Windows/Python 3.12 runtime constraints resolved without the historical diskcache dependency or reported known vulnerabilities. Run the bridge on localhost. See the dev3 review and historical security review.

New users: start with installation and configuration. This repository is the public free source edition; no private/full edition files are needed.

Windows / Python 3.12 / FL Studio 26.1.5 build 5618. Based on rosasynthesiz/flstudio-mcp; MIT retained. Development preview, not universal desktop automation. No running MCP configuration/controller is replaced.

Core tested edits use actual GUI input. Prefer UIA where controls exist; self-drawn Piano Roll, Playlist, Sytrus and Mixer use screenshot-confirmed window-relative targets. FLP parsing and read-only bridge calls verify results, not perform musical edits.

Default mode hides legacy background music writers. Explicit FLSTUDIO_MCP_ENABLE_LEGACY_WRITES=1 exposes compatibility tools; never describe those writes as GUI actions.

See capabilities, real acceptance, workflow, profiles. GUI input receipts deliberately return verified=false: observe post-state, save and independently verify the musical target.

Isolated installation

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --index-url https://pypi.org/simple -e ".[dev,audio]"
.\.venv\Scripts\python.exe -m pip check
.\.venv\Scripts\python.exe -m pytest tests/test_ui_first.py -q

Full inherited regression explicitly exercises legacy writers against unit fakes, not real FL:

$env:FLSTUDIO_MCP_ENABLE_LEGACY_WRITES = '1'
try { .\.venv\Scripts\python.exe -m pytest tests -q }
finally { Remove-Item Env:FLSTUDIO_MCP_ENABLE_LEGACY_WRITES }

GUI operations require an interactive Windows desktop. Use an isolated preserved test project, stop transport, avoid simultaneous manual input, and retain checkpoints. fl_gui_save_as first establishes owned project identity. Existing compatible controller/loopMIDI bridge is needed for read-only verification and Playlist transport checks. Do not reinstall or overwrite an existing controller automatically. Review the example configuration separately; it is not merged into running configuration.

Bridge and candidate must share the private state directory for cooperating OS locks. Unrelated processes/manual edits cannot be locked. Unknown modals/layouts fail safely. Dev2 verifies one Sytrus factory-preset path, automation creation/move/curve-value edit, and strict saved/audio readback. No universal third-party, all-DPI, audio-clip or arbitrary routing/FX support. Private logs, screenshots, FLPs/WAVs and commercial content stay outside public source. A local ZIP is not GitHub publication.

Install Windows OCR language capabilities for the actual UI (tested zh-Hans and en-US). If OCR is unavailable or ambiguous, operations stop and retain diagnostics. Generator readback indices follow the current Channel Rack filter: select All through GUI and pass expected_channel to fl_plugin_state.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to control FL Studio on Windows through a local MCP server without cloud dependencies. Bridges MCP clients to FL Studio's Python scripting environment via file-based IPC for project management, transport control, and UI workflow automation.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to control FL Studio through an MCP interface, including running Python inside FL, capturing screenshots, sending clicks and keystrokes, writing multi-channel piano roll notes, and building full arrangements from a song spec without moving the cursor.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI agent to compose and mix directly inside FL Studio: writing and clearing notes, setting tempo, levels and plugin parameters, inspecting what FL currently holds, checking which channels sound, and rendering the arrangement to WAV.
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables reading saved FL Studio 21 patterns, channels, arrangements, and MIDI; preparing native Piano Roll snapshots and append commands; and coordinating note additions executed inside FL Studio via companion scripts and a separately configured UI agent.
      GPL 3.0