A Model Context Protocol server for VMware Workstation. Control virtual machines from AI assistants like Claude Code via the vmrun CLI.
- VM lifecycle (start, stop, restart)
- Snapshots (create, restore, list, delete)
- File transfer (host <-> guest)
- Run commands and scripts in guest
- Process management, screen capture, IP lookup
- Python 3.10+
- VMware Workstation Pro (with
vmrunin PATH or configured path) - VMware Tools installed in guest VMs
claude mcp add --transport stdio vmware -- \
uvx --from git+https://github.com/slupro/vmware-mcp.git vmware-mcp \
--config ~/vmware-mcp.jsonOr install from source:
pip install git+https://github.com/slupro/vmware-mcp.git
claude mcp add --transport stdio vmware -- vmware-mcp --config ~/vmware-mcp.jsonCreate a config.json (see config.example.json):
{
"vmrun_path": "C:\\Program Files (x86)\\VMware\\VMware Workstation\\vmrun.exe",
"default_timeout": 120,
"vms": {
"my-test-vm": {
"vmx": "D:\\VMs\\TestVM\\TestVM.vmx",
"guest_user": "Administrator",
"guest_password": "${VM_PASSWORD}",
"snapshot": "clean",
"description": "Test environment"
}
}
}Passwords use ${ENV_VAR} syntax — set them as environment variables in your MCP config:
{
"mcpServers": {
"vmware": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/slupro/vmware-mcp.git",
"vmware-mcp", "--config", "/path/to/config.json"
],
"env": { "VM_PASSWORD": "your-password" }
}
}
}| Category | Tools |
|---|---|
| Lifecycle | vm_list, vm_start, vm_stop, vm_restart |
| Snapshots | vm_snapshot_list, vm_snapshot_create, vm_snapshot_restore, vm_snapshot_delete |
| Files | vm_copy_to_guest, vm_copy_from_guest, vm_file_exists, vm_directory_exists |
| Execution | vm_run_command, vm_run_script, vm_list_processes, vm_kill_process, vm_capture_screen |
| Info | vm_get_ip, vm_read_variable |
When running from WSL, the server automatically converts Windows executable paths (e.g. C:\Program Files\...\vmrun.exe) to WSL mount paths (/mnt/c/...). VM and guest paths stay in Windows format as vmrun.exe expects them.
MIT