How do I use midi-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@midi-mcp list my MIDI ports and send a middle C note to channel 1" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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)