vmware-fusion-mcp-server
Allows managing VMware Fusion virtual machines, including listing, starting, stopping, suspending, resetting VMs, managing snapshots, checking VMware Tools, and running commands in guest OS.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vmware-fusion-mcp-server List all my virtual machines"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VMware Fusion MCP Server
An MCP (Model Context Protocol) server that lets AI assistants manage VMware Fusion virtual machines on macOS via the vmrun command-line tool.
Prerequisites
macOS with VMware Fusion (or Fusion Pro) installed
Node.js >= 18
The
vmrunbinary (bundled with VMware Fusion at/Applications/VMware Fusion.app/Contents/Library/vmrun)
Related MCP server: VMware MCP Server
Installation
cd vmware-fusion-mcp-server
npm install
npm run buildConfiguration
Claude Desktop / Claude Code
Add this to your MCP settings (e.g. claude_desktop_config.json or .claude.json):
{
"mcpServers": {
"vmware-fusion": {
"command": "node",
"args": ["/path/to/vmware-fusion-mcp-server/dist/index.js"],
"env": {}
}
}
}Custom vmrun path
If VMware Fusion is installed in a non-standard location, set the VMRUN_PATH environment variable:
{
"env": {
"VMRUN_PATH": "/custom/path/to/vmrun"
}
}Available Tools
Tool | Description |
| List all currently running VMs |
| Discover all VMs on the system (scans common directories) |
| Get detailed info about a specific VM (OS, RAM, CPUs, IP) |
| Start (power on) a VM, optionally headless |
| Stop a VM (soft/graceful or hard/forced) |
| Suspend a running VM to disk |
| Reboot a VM (soft or hard) |
| Get the guest OS IP address |
| List all snapshots of a VM |
| Create a new snapshot |
| Revert to a previous snapshot |
| Delete a snapshot |
| Check VMware Tools status in the guest |
| Run a program inside the guest OS |
Example Usage
Once connected, you can ask your AI assistant things like:
"List all my virtual machines"
"Start my Ubuntu VM"
"What's the IP address of my Windows VM?"
"Create a snapshot called 'before-update' for my dev VM"
"Stop all running VMs gracefully"
How It Works
The server wraps VMware Fusion's vmrun CLI utility and exposes its functionality as MCP tools. It automatically discovers VMs by scanning standard macOS VM directories (~/Virtual Machines.localized, etc.) and reads .vmx configuration files to extract VM metadata like display names, guest OS type, memory, and CPU count.
License
MIT
Available Tools
14 toolsfusion_check_toolsCheck VMware Tools StatusBRead-onlyIdempotent
Check the status of VMware Tools in a virtual machine's guest OS.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
Returns: The VMware Tools status (e.g., "installed", "running", "not installed").
Inputs: vmx_path (required), vm_password.
fusion_create_snapshotCreate SnapshotB
Create a new snapshot of a VMware Fusion virtual machine.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
snapshot_name (string): Name for the new snapshot.
Returns: Confirmation message on success.
Inputs: vmx_path (required), snapshot_name (required), vm_password.
fusion_delete_snapshotDelete SnapshotADestructive
Delete a snapshot from a VMware Fusion virtual machine.
WARNING: This permanently removes the snapshot and its state. This cannot be undone.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
snapshot_name (string): Name of the snapshot to delete.
Returns: Confirmation message on success.
Inputs: vmx_path (required), snapshot_name (required), vm_password.
fusion_get_ipGet VM IP AddressARead-onlyIdempotent
Get the IP address of a running VMware Fusion guest OS.
The VM must be running and have VMware Tools installed for this to work.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
wait (boolean, optional): If true, waits for the guest to obtain an IP. Default: true.
Returns: The IP address as a string, or an error if unavailable.
Inputs: vmx_path (required), wait, vm_password.
fusion_get_vm_infoGet VM DetailsARead-onlyIdempotent
Get detailed information about a specific VMware Fusion virtual machine.
Reads the .vmx configuration file and checks running status.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
Returns: Object with name, vmxPath, guestOS, memoryMB, numCPUs, annotation, hardwareVersion, running status.
Inputs: vmx_path (required), vm_password.
fusion_list_allDiscover All VMsARead-onlyIdempotent
Discover all VMware Fusion virtual machines on the system by scanning common VM directories.
Scans ~/Virtual Machines.localized and related paths for .vmx files. Also accepts an optional extra directory to search.
Args:
extra_dir (string, optional): Additional directory path to scan for VMs.
Returns:
total: number of VMs found
vms: array of { name, vmxPath, guestOS, memoryMB, numCPUs }
Inputs: extra_dir.
fusion_list_runningList Running VMsARead-onlyIdempotent
List all currently running VMware Fusion virtual machines.
Returns the count and paths of all running VMs, along with their display names.
Returns:
total: number of running VMs
vms: array of { name, vmxPath }
Note: Only VMs started by the current user are shown (use sudo for root-started VMs).
Inputs: no named parameters.
fusion_list_snapshotsList VM SnapshotsARead-onlyIdempotent
List all snapshots of a VMware Fusion virtual machine.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
Returns:
total: number of snapshots
snapshots: array of snapshot names
Inputs: vmx_path (required), vm_password.
fusion_reset_vmReset VMBDestructive
Reset (reboot) a VMware Fusion virtual machine.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
mode (string, optional): "soft" for graceful reboot, "hard" for forced reset. Default: "soft".
Returns: Confirmation message on success.
Inputs: vmx_path (required), mode, vm_password.
fusion_revert_snapshotRevert to SnapshotADestructiveIdempotent
Revert a VMware Fusion virtual machine to a previous snapshot.
WARNING: This discards any changes made since the snapshot was taken.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
snapshot_name (string): Name of the snapshot to revert to.
Returns: Confirmation message on success.
Inputs: vmx_path (required), snapshot_name (required), vm_password.
fusion_run_in_guestRun Program in GuestA
Run a program inside a VMware Fusion guest OS.
Requires VMware Tools to be installed and running in the guest.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
guest_user (string): Username for guest authentication.
guest_password (string): Password for guest authentication.
program (string): Full path to the program inside the guest OS.
program_args (string, optional): Arguments to pass to the program.
no_wait (boolean, optional): If true, returns immediately without waiting for the program to finish. Default: false.
Returns: Output from the program or confirmation that it was launched.
Inputs: program (required), vmx_path (required), guest_user (required), guest_password (required), +3 more.
fusion_start_vmStart VMAIdempotent
Start (power on) a VMware Fusion virtual machine.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
nogui (boolean, optional): If true, starts the VM without a GUI window (headless). Default: false.
Returns: Confirmation message on success.
Inputs: vmx_path (required), nogui, vm_password.
fusion_stop_vmStop VMADestructiveIdempotent
Stop (power off) a VMware Fusion virtual machine.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
mode (string, optional): "soft" sends a shutdown signal to the guest OS (graceful). "hard" forces immediate power off. Default: "soft".
Returns: Confirmation message on success.
Inputs: vmx_path (required), mode, vm_password.
fusion_suspend_vmSuspend VMAIdempotent
Suspend a running VMware Fusion virtual machine. Saves the VM's state to disk.
Args:
vmx_path (string): Absolute path to the VM's .vmx file.
Returns: Confirmation message on success.
Inputs: vmx_path (required), vm_password.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have clearly distinct purposes, but `fusion_list_running` and `fusion_list_all` both 'list' VMs which could cause initial confusion; descriptions clarify the scope difference. Snapshot, lifecycle, and guest operations are unambiguous.
All tools follow the `fusion_<verb>_<object>` pattern (e.g., `create_snapshot`, `start_vm`, `get_ip`). Even `list_running` and `list_all` fit the pattern with a gerund/adjective as the object, maintaining consistency across the set.
14 tools is well-scoped for a VMware Fusion control server, covering VM lifecycle, snapshots, guest operations, and discovery. Each tool serves a distinct purpose with no obvious redundancy or bloat.
The tool set adequately covers common VM management tasks: start/stop/suspend/reset, snapshot CRUD, guest program execution, and info retrieval. Missing operations like VM creation/deletion are reasonable omissions for a control-focused server, but could be considered minor gaps for a full lifecycle.
Maintenance
Related MCP Connectors
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Linux VMs for AI agents: create VMs, run commands, edit files and open preview URLs.
Connect AI assistants to explicitly paired computers, servers, and VMs for permitted remote actions.
Linux machines for AI agents: create, run commands, snapshot, fork, sandbox. Alpha.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables managing VMware Workstation Pro VMs via MCP tools, including power operations, snapshots, guest processes, and network configuration through the vmrest, vmrun, and vmcli interfaces.2-
- FlicenseNot gradedqualityBmaintenanceEnables management of VMware Workstation virtual machines, including lifecycle and snapshot operations, through MCP tools accessible by AI assistants.-
- FlicenseNot gradedqualityBmaintenanceEnables controlling VMware Workstation Pro virtual machines, including listing, power management, snapshots, cloning, guest operations, networking, and screenshots.-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to manage local VMware Workstation, Fusion, and Player virtual machines via vmrun, including power control, snapshots, guest file operations, and screen captures.BSD 2-Clause "Simplified"