README.md
Control electronic music instruments via MIDI using Claude
midi-mcp
MCP server that lets Claude control electronic music instruments via MIDI. Exposes tools for sending MIDI messages (notes, CC, program changes, pitch bend, sysex) to hardware synths and drum machines connected via USB or DIN MIDI.
Setup
Requires uv.
cd midi-mcp
uv sync
Usage
Add to Claude Code
claude mcp add midi-mcp -- uv --directory /path/to/midi-mcp run midi-mcp
Or add manually to your MCP config:
{
"mcpServers": {
"midi-mcp": {
"command": "uv",
"args": ["--directory", "/path/to/midi-mcp", "run", "midi-mcp"]
}
}
}
Run standalone
uv run midi-mcp
Tools
| Tool | Description |
|---|---|
list_midi_ports |
List available MIDI output ports |
open_midi_port |
Open a specific MIDI output port by name |
close_midi_port |
Close the currently open port |
get_midi_status |
Return current port name and connection state |
send_note_on |
Send Note On (channel, note, velocity) |
send_note_off |
Send Note Off (channel, note, velocity) |
send_cc |
Send Control Change (channel, control, value) |
send_program_change |
Send Program Change (channel, program) |
send_pitchwheel |
Send Pitch Bend (channel, value) |
send_sysex |
Send SysEx message (list of data bytes) |
Dependencies
- mcp[cli] - MCP Python SDK with FastMCP
- mido - MIDI message library
- python-rtmidi - Real-time MIDI I/O backend
Tools (10)
list_midi_portsList available MIDI output portsopen_midi_portOpen a specific MIDI output port by nameclose_midi_portClose the currently open portget_midi_statusReturn current port name and connection statesend_note_onSend Note On (channel, note, velocity)send_note_offSend Note Off (channel, note, velocity)send_ccSend Control Change (channel, control, value)send_program_changeSend Program Change (channel, program)send_pitchwheelSend Pitch Bend (channel, value)send_sysexSend SysEx message (list of data bytes)Configuration
claude_desktop_config.json
{"mcpServers": {"midi-mcp": {"command": "uv", "args": ["--directory", "/path/to/midi-mcp", "run", "midi-mcp"]}}}Try it
→List all available MIDI output ports connected to my computer.
→Open the MIDI port named 'USB MIDI Interface' and send a Note On message for middle C at velocity 100.
→Send a Control Change message on channel 1 to set CC 74 to value 64.
→Close the current MIDI port after finishing the sequence.