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-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OtherSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| fl-studio-mcp (this skill)by Zierax | 83 | 10 | 2d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.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.
Skill content
View source on GitHubFL 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)
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,pathliborimportlib. 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
- 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 Controllerand 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
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
