SkillAgentSearch skills...

fl-studio-mcp

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.

Install / Use

claude mcp add Zierax -- npx -y github:Zierax/fl-studio-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

83/100

Category

Other

Supported Platforms

Claude Code
Claude Desktop

Our assessment of fl-studio-mcp

fl-studio-mcp scores 83/100 on our quality scale, 240th of 329 Other skills we index.

Its MCP Server is 8.1 KB long, well organised into 18 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 2 days ago, so fl-studio-mcp is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

fl-studio-mcp compared with similar skills

All 4 of these similar skills score higher than fl-studio-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
fl-studio-mcp (this skill)by Zierax83102d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install fl-studio-mcp?
Run claude mcp add Zierax -- npx -y github:Zierax/fl-studio-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does fl-studio-mcp work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is fl-studio-mcp safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is fl-studio-mcp still maintained?
The repository was last updated 2 days ago, so fl-studio-mcp is actively maintained.

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.2.0 · MIT License · © 2026 Ziad Salah (Zierax)

Listed on MCP Market


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 and FL Studio 21.0.3 / Windows)
  • Python 3.10+
  • uv (recommended package manager)
  • A virtual MIDI port:
    • Windows: loopMIDI
    • macOS: IAC Driver (enable it in Audio MIDI Setup)

FL Studio 21 and older: FL Studio embeds a stripped CPython interpreter without the standard library, so the controller script uses nothing but builtins — no json, os, pathlib or importlib. Nothing extra has to be installed for those versions.

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

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

3. Connect the server

Add this to your MCP client's configuration file (Claude Desktop: claude_desktop_config.json; Claude Code: ~/.claude.json):

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

Replace /path/to/FL-MCP with the folder you cloned the repository into. On Windows use a path with escaped backslashes, e.g. "D:\\Projects\\FL-MCP". 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."

4. Check the bridge

Ask your client to run fl_diagnostics. It reports the MIDI port in use, the folder the command files live in, and the FL Studio API version — the fastest way to see what is misconfigured.

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, testing, releasing | | docs/MENTION.md | Credits and backbone projects | | CHANGELOG.md | What changed in each release |

AI prompt pack

prompts/ turns the server into a producer rather than a command runner: a standing directive, the tool map and read-back pairings, the nine-phase production workflow, style specs for twelve genres, and checkable quality gates.

| File | What it does | |------|--------------| | prompts/CORE.md | The standing directive — role, verification invariant, creative rules | | prompts/BRIDGE.md | Tool map, FL API limits, failure branches, recovery | | prompts/WORKFLOW.md | The nine production phases, with a gate at the end of each | | prompts/RECIPE.md | The style card and a worked example | | prompts/GENRES.md | Twelve style specs with real numbers | | prompts/ARRANGEMENT.md | Energy curves, section lengths, layer logic, hooks | | prompts/THEORY.md | Key and mode, bass writing, melody craft | | prompts/MIXING.md | Balance → pan → routing → EQ → FX → automation → loudness | | prompts/QC.md | Quality gates and the diagnostic table for a weak result |

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,
                            port scoring, path resolution
  tools/                  ← 9 tool groups: transport, mixer, channels, patterns,
                             plugins, sequencer, piano_roll, advanced, fullcontrol
scripts/                  ← installer helpers, scenario harness, benchmark
prompts/                  ← the AI prompt pack (directive, workflow, styles, gates)
tests/                    ← pytest suite (controller script, JSON codec, ports, prompts)
logs/                     ← run artifacts: execution logs, scenario and benchmark reports
docs/                     ← this documentation
install.ps1 / install.sh  ← one-command installers

Development

uv sync
uv run pytest            # unit tests (no FL Studio required)
uv run ruff check src/ tests/ fl_controller/device_FLStudioMCP.py

See docs/DEVELOPMENT.md for the full workflow.

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.

Related Skills

View on GitHub
GitHub Stars10
CategoryOther
Updated2d ago
Forks1

Languages

Python

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info