X32/M32 MCP Server

MCP server for controlling Behringer X32/M32 digital mixing consoles via OSC protocol.

When to Use This

• Remote Mixing: Control your X32/M32 from anywhere on the network
• Automated Setup: Quickly configure channels for rehearsals or shows
• Batch Operations: Apply settings to multiple channels at once
• Documentation: Query and document current mixer settings
• Troubleshooting: Check mixer state without physical access
• Live Adjustments: Make quick changes during performances via AI assistant

Features

• 32 input channels with volume, gain, mute, solo, EQ, pan control
• 16 mix buses for aux sends and monitor mixes
• 8 FX racks with parameter control
• Main/monitor output control
• Direct OSC parameter access for advanced users

Installation

Recommended: Published package (quick start)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "x32": {
            "command": "npx",
            "args": ["x-m32-mcp-server"]
        }
    }
}

This runs the published npm package, so you do not need to clone this repo.

From source: Local checkout

git clone https://github.com/GoBeromsu/X32-MCP.git
cd X32-MCP
npm install
npm run build

Then point Claude Desktop at the local build output:

{
    "mcpServers": {
        "x32": {
            "command": "node",
            "args": ["/absolute/path/to/X32-MCP/dist/index.js"]
        }
    }
}

After code changes, run npm run build again so Claude Desktop uses the updated dist/ output.

Connect to Mixer

connection_connect with host="192.168.1.100" and port=10023

Available Tools (25 total)

| Tool | Parameters | | ----------------------- | --------------------------------------- | | Connection (4) | | | connection_connect | host, port | | connection_disconnect | - | | connection_get_info | - | | connection_get_status | - | | Channel (9) | | | channel_set_volume | channel, value, unit | | channel_set_gain | channel, gain | | channel_mute | channel, muted | | channel_solo | channel, solo | | channel_get_state | channel | | channel_set_name | channel, name | | channel_set_color | channel, color | | channel_set_pan | channel, pan | | channel_set_eq_band | channel, band, parameter, value | | Bus (4) | | | bus_set_volume | bus, value, unit | | bus_mute | bus, muted | | bus_set_send | channel, bus, value, unit | | bus_get_state | bus | | FX (3) | | | fx_set_parameter | fx, parameter, value | | fx_get_state | fx | | fx_bypass | fx, bypass | | Main/Monitor (3) | | | main_set_volume | value, unit | | main_mute | muted | | monitor_set_level | value, unit | | Low-Level (2) | | | get_parameter | address | | set_parameter | address, value |

Quick Tips

• Unity Gain: 0 dB = 0.75 linear (neutral, no boost/cut)
• Safe Start: Begin with channel at -20 dB and muted
• Channel Colors: Use colors to organize (red=vocals, blue=drums, etc.)
• Bus Usage: 1-4 monitors, 5-6 FX sends, 7-8 recording, 9-16 IEM/matrix
• Network: X32 uses port 10023, connect to same network as computer

Parameter Reference

Common Parameters

• channel: 1-32
• bus: 1-16
• fx: 1-8
• unit: "linear" (0.0-1.0) or "db" (-90 to +10)
• muted/solo/bypass: true/false
• pan: -100 to +100, "L50"/"C"/"R50", or 0.0-1.0
• color: "red", "green", "blue", etc. or 0-15
• band: 1-4 (EQ bands)
• parameter: "f" (frequency), "g" (gain), "q" (Q factor)

Value Ranges

• Volume linear: 0.0-1.0 (unity = 0.75)
• Volume dB: -90 to +10 (unity = 0 dB)
• Gain: 0.0-1.0
• FX parameter: 0.0-1.0
• Channel name: max 12 characters

License

MIT

Support

https://github.com/GoBeromsu/X32-MCP