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"

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

Development Status
- 4 - Beta
Operating System
- Microsoft :: Windows
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

voicemeeter_mcp-0.2.0.tar.gz (9.3 kB view details)

Uploaded Jul 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

voicemeeter_mcp-0.2.0-py3-none-any.whl (9.6 kB view details)

Uploaded Jul 28, 2026 Python 3

File details

Details for the file voicemeeter_mcp-0.2.0.tar.gz.

File metadata

Download URL: voicemeeter_mcp-0.2.0.tar.gz
Upload date: Jul 28, 2026
Size: 9.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for voicemeeter_mcp-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`b422dca711f6ba6ee04c37b0a8747307118e59c608d31460c78e9d7678d20e94`
MD5	`3291daa650235430ffe11831372e3dbe`
BLAKE2b-256	`fdbcd417abbf5f3c814baf754a984203acfc3b973dac24eedd89c2aadd63e492`

See more details on using hashes here.

Provenance

The following attestation bundles were made for voicemeeter_mcp-0.2.0.tar.gz:

Publisher: publish.yml on aaronckj/voicemeeter-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: voicemeeter_mcp-0.2.0.tar.gz
- Subject digest: b422dca711f6ba6ee04c37b0a8747307118e59c608d31460c78e9d7678d20e94
- Sigstore transparency entry: 2275304455
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: aaronckj/voicemeeter-mcp@9db0b4a574106958f42790678a9415f2bec0d9be
- Branch / Tag: refs/tags/v0.2.0
- Owner: https://github.com/aaronckj
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@9db0b4a574106958f42790678a9415f2bec0d9be
- Trigger Event: push