Skip to main content
Glama
midi-mcp

midi-mcp

by pnilan

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

Related MCP server: FL Studio MCP

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

Available Tools

10 tools
close_midi_portB

Close the currently open MIDI port.

Inputs: no named parameters.

get_midi_statusB

Return current MIDI connection status.

Inputs: no named parameters.

list_midi_portsB

List available MIDI output ports.

Inputs: no named parameters.

open_midi_portA

Open a MIDI output port by name. Use list_midi_ports to see available ports.

Inputs: name (required).

send_ccC

Send a MIDI Control Change message.

Args:
    channel: MIDI channel (0-15)
    control: CC number (0-127)
    value: CC value (0-127)

Inputs: channel (required), control (required), value (required).

send_note_offA

Send a MIDI Note Off message.

Args:
    channel: MIDI channel (0-15)
    note: Note number (0-127)
    velocity: Release velocity (0-127, usually 0)

Inputs: channel (required), note (required), velocity.

send_note_onA

Send a MIDI Note On message.

Args:
    channel: MIDI channel (0-15)
    note: Note number (0-127). 60 = middle C.
    velocity: Velocity (0-127)

Inputs: channel (required), note (required), velocity (required).

send_pitchwheelA

Send a MIDI Pitch Bend message.

Args:
    channel: MIDI channel (0-15)
    value: Pitch bend value (-8192 to 8191, 0 = center)

Inputs: channel (required), value (required).

send_program_changeA

Send a MIDI Program Change message.

Args:
    channel: MIDI channel (0-15)
    program: Program number (0-127)

Inputs: channel (required), program (required).

send_sysexB

Send a MIDI System Exclusive message.

Args:
    data: List of SysEx data bytes (0-127 each, without F0/F7 framing)

Inputs: data (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a distinct purpose with no overlap: port management (list/open/close/status), and specific MIDI message types (note on/off, CC, pitch bend, program change, sysex). The descriptions clearly differentiate them, eliminating any ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case (e.g., list_midi_ports, send_note_on). The verbs are appropriate and predictable across the set, making the naming highly consistent.

    Tool Count5/5

    With 10 tools, this server is well-scoped for MIDI operations. It covers essential port management and a comprehensive set of MIDI message types, with each tool serving a clear and necessary function in the domain.

    Completeness5/5

    The tool set provides complete coverage for basic MIDI output: port lifecycle (list, open, close, status) and all standard message types (note on/off, CC, pitch bend, program change, sysex). There are no obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers