voicemeeter-mcp

An MCP (Model Context Protocol) server for controlling Voicemeeter (Basic, Banana, or Potato) on Windows: strip and bus gains, mutes, output routing, live levels, macro buttons, presets, and audio-engine restarts.

• Uses the official Voicemeeter Remote API (via voicemeeter-api).

• Windows-only, local-only — the Remote API is an in-process DLL, so this server must run on the PC where Voicemeeter runs. From another machine, connect over SSH stdio (example below).

• Every mutating tool accepts dry_run=true and returns a preview instead of acting.

Quick start (on the Voicemeeter PC)

# select your edition: basic | banana | potato   (default: banana)
set VM_MCP_KIND=banana

claude mcp add voicemeeter -s user -- uvx voicemeeter-mcp

From a different machine (SSH stdio):

claude mcp add voicemeeter -s user -- ssh streampc "uvx voicemeeter-mcp"

Related MCP server: reaper-mcp-server

Tools

A typical agent ask: "the game audio is too loud on stream" → mixer_state to find the strip by label → set_strip_gain(strip, -12).

Development

pip install -e '.[dev]'
ruff check src tests && pytest

Tests run anywhere (fake Remote API); only live use requires Windows.

License

MIT