Skip to main content
Glama
Sign In
FL Studio MCP

FL Studio MCP

by prodlunaro-sketch
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

FL Studio MCP

FL Studio MCP connects an MCP client to FL Studio through a virtual MIDI port and a small controller script that runs inside FL Studio. It lets an assistant inspect and edit many parts of an open project, including transport, mixer, channels, patterns, notes, and plugin parameters.

The repository also includes an optional Windows desktop adapter. It can take screenshots, try a sample drop into the Playlist, use the Plugin Picker, and render a saved project through FL Studio's command-line renderer. Those actions depend on the visible Windows desktop and should be checked in FL Studio after they run.

This project is maintained at prodlunaro-sketch/fl-studio-mcp. It builds on the MIT-licensed work by Zierax and earlier contributors. See Credits for the source projects.

What it can do

  • Control playback, recording, tempo, loop mode, and song position.

  • Read and change mixer tracks, channel settings, patterns, step sequences, and piano-roll notes.

  • Inspect and change parameters for plugins already loaded in the project.

  • Discover functions exposed by the installed FL Studio scripting API and call them through the raw API tools.

  • Read project, playlist, mixer, channel, and transport state.

  • Analyze an exported audio file with FFmpeg, including loudness, peaks, duration, and silence intervals.

  • On Windows, use optional desktop controls for screenshots, sample drops, plugin insertion, and rendering a saved .flp file.

FL Studio's scripting API cannot create a channel or load a sample into one. The Windows adapter can attempt a sample drop into the Playlist, and it can open the Plugin Picker. These UI actions need visual review. See Limitations.

Related MCP server: FL Studio MCP Server

Requirements

  • FL Studio 20.7 or newer, with its MIDI controller scripting API.

  • Python 3.10 or newer and uv.

  • A virtual MIDI port: loopMIDI on Windows, or the IAC Driver on macOS.

  • For Windows desktop tools, Windows with FL Studio open in the same logged-in desktop session. Install the optional windows-ui dependencies.

  • For audio analysis, ffmpeg and ffprobe available on PATH.

Quick start

Clone the repository, install Python dependencies, and install the FL Studio controller script. Full Windows and macOS instructions are in Setup.

uv sync

For Windows desktop tools, install the optional dependencies:

uv sync --extra windows-ui

Start loopMIDI and add a port. Copy fl_controller/device_FLStudioMCP.py into FL Studio's Settings/Hardware/FLStudioMCP folder, then select FL Studio MCP Controller for that MIDI input in FL Studio's MIDI settings. Restart FL Studio or update its MIDI scripts.

Configure your MCP client to launch the server from this repository. The command is:

uv run --directory <path-to-this-repository> fl-studio-mcp

The exact configuration format depends on the MCP client. The setup guide includes a JSON example. After connecting, call fl_connection_status to check the MIDI bridge.

Guides

Document

Contents

User guide

Setup checklist, working features, examples, and known limits

Setup

Windows and macOS installation instructions

Tool catalog

MCP tools grouped by function

Architecture

MIDI and JSON bridge, controller script, and hot reload

Troubleshooting

Common connection and setup issues

Limitations

FL Studio API limits and Windows UI adapter scope

Development

Project structure and contribution notes

Project layout

fl_controller/                 Script loaded by FL Studio
src/fl_studio_mcp/server.py    MCP server entry point
src/fl_studio_mcp/tools/       Transport, mixer, channel, pattern, and other tools
scripts/                       Setup helpers and piano-roll script
docs/                          Setup and feature documentation

License

MIT. See LICENSE and Credits.

Tool Schema Changelog

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

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • FL Studio MCP Server

      unicornwhodev-afk
      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.
      -

    • fl-bridge-mcp

      MadBlast0
      A
      license
      C
      quality
      C
      maintenance
      Gives AI assistants full control of FL Studio through its scripting API, enabling project editing, mixing, piano roll composition, MIDI export, and plugin automation without touching the mouse or keyboard.
      57
      2
      MIT