Installation Guide¶

Complete installation guide for FL Studio MCP Server.

Prerequisites¶

Python 3.10 or higher
uv package manager (recommended)
FL Studio (for FL Studio API features)
loopMIDI (for MIDI features)

Quick Start¶

# Install and run with uvx (easiest method)
uvx fruityloops-mcp

Installation Methods¶

Method 1: Using uvx (Recommended)¶

The fastest way to run the server without installation:

uvx fruityloops-mcp

Method 2: Using uv tool¶

Install as a uv tool for persistent use:

# Install
uv tool install fruityloops-mcp

# Run
uv tool run fruityloops-mcp

Method 3: Using pip¶

Traditional pip installation:

# Install
pip install fruityloops-mcp

# Run
fruityloops-mcp

Method 4: From Source¶

For development or the latest features:

# Clone repository
git clone https://github.com/quinnjr/fruityloops-mcp.git
cd fruityloops-mcp

# Install with uv
uv sync --all-extras

# Run
uv run fruityloops-mcp

FL Studio Integration¶

Python API Setup¶

Enable Python API in FL Studio:
Options → MIDI Settings
Enable "Script output" for your controller
Select "Generic Controller" as the controller type
Verify API Access:
FL Studio must be running for API features to work
MIDI features work independently of FL Studio

loopMIDI Setup¶

Installation¶

Download loopMIDI
Run the installer
Launch loopMIDI

Configuration¶

Create Virtual Port:
Click the + button in loopMIDI
Name: FLStudio_MIDI
Click "Create"
Configure FL Studio:
Options → MIDI Settings
Enable the FLStudio_MIDI port under "Input"
Enable the port under "Output"

Test Connection:

uvx fruityloops-mcp
# Then use midi_list_ports tool

MCP Client Setup¶

Claude Desktop¶

Add to claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fruityloops": {
      "command": "uvx",
      "args": ["fruityloops-mcp"]
    }
  }
}

Other MCP Clients¶

The server uses stdio transport and works with any MCP-compatible client.

Verification¶

Test the Installation¶

# Run the server
fruityloops-mcp

# In another terminal, test with an MCP client
# or configure your MCP client to use the server

Verify MIDI Connection¶

# In your MCP client, try:
# 1. midi_list_ports - Should show FLStudio_MIDI
# 2. midi_connect - Should connect successfully
# 3. midi_send_note - Should send a MIDI note