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=trueand 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"
Tools
| Tool | Purpose |
|---|---|
mixer_state |
full snapshot: every strip/bus with label, gain, mute, routing |
set_strip_gain / mute_strip |
input fader control |
set_strip_routing |
send a strip to A1/A2/A3/B1/B2 outputs |
set_bus_gain / mute_bus |
output control |
get_levels |
live post-fader levels — find silent or clipping paths |
trigger_macro_button |
press a Voicemeeter macro button |
load_preset |
load a settings XML |
restart_audio_engine |
the classic crackle fix |
health_check |
connection + version |
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
1 maintainer
Metadata
1 maintainer
Release files for voicemeeter-mcp 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| voicemeeter_mcp-0.2.4.tar.gz | 11.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| voicemeeter_mcp-0.2.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.4 kB
Release files / voicemeeter_mcp-0.2.4.tar.gz
| Download URL | voicemeeter_mcp-0.2.4.tar.gz |
|---|---|
| Size | 11.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72bba788a5734bd2ca443081478cbb69750fad4070ceebddacd3f6df1d71fb39
|
|
BLAKE2b-256 checksum How to use checksums |
2e81bf5cafb6ff2667bb80b6ffd7c158343323267e45b40a04b1241c7b900212
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.
Transparency logRelease files / voicemeeter_mcp-0.2.4-py3-none-any.whl
| Download URL | voicemeeter_mcp-0.2.4-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8073b24e5a1b57f0192ce28707b6e22fdfbcffb3d39d7c6a57b7d7c4d189058f
|
|
BLAKE2b-256 checksum How to use checksums |
5d1a9b183ce9574280fef7ab4b08fbace92eb675c05dd29a293b24f060a1e913
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.
Transparency log
