voicemeeter

This MCP server exposes a set of tools that allow an AI agent or MCP client to control and monitor Voicemeeter through the official Voicemeeter Remote API. You can connect, read and set a wide range of parameters (mute, gain, routing, etc.), monitor real-time audio levels, load Voicemeeter XML presets, and launch Voicemeeter applications. The server aggregates these capabilities behind tools such as voicemeeter_connect, voicemeeter_disconnect, voicemeeter_get_parameter, voicemeeter_set_parameter, voicemeeter_get_levels, voicemeeter_load_preset, and voicemeeter_run, enabling seamless automation from MCP clients like Claude Desktop or other agents.

To use it, run the server locally and configure your MCP client to point at the VOICEMEETER MCP server entry. The client can then call the available tools by name, passing parameters as needed. For example, you can connect to the Voicemeeter Remote API, mute a specific input strip, adjust a bus gain, or request current level readings, then react programmatically within your agent based on the results.

Prerequisites:

• Python 3.8 or higher
• Voicemeeter installed on Windows (Remote API required)
• Access to the Voicemeeter Remote API from the host running the MCP server

Install from source:

git clone <repository-url>
cd voicemeeter-mcp-server
pip install -e .

Install development dependencies (optional):

pip install -e ".[dev]"

Run the server:

voicemeeter-mcp-server

Or directly with Python (useful for debugging):

python -m voicemeeter_mcp_server.main

Tips and caveats:

• Ensure Voicemeeter is installed and running before starting the MCP server.
• If you encounter connection issues, try running the server with elevated privileges (Administrator) to access the Voicemeeter Remote API.
• The server supports all Voicemeeter versions (Standard, Banana, Potato); parameter names follow the Voicemeeter Remote API conventions (e.g., Strip[0].mute, Bus[1].gain).
• Use the VOICEMEETER_DEBUG environment variable to enable verbose logging for troubleshooting.
• When integrating with an MCP client, add the voicemeeter server entry to your client configuration with the command that starts the server (Python entrypoint shown in mcp_config).
• If you modify presets or scripts, run the test suite (pytest) and static checks (black, isort, mypy) to maintain quality.