Skip to main content
Glama
vmware-fusion-mcp-server

vmware-fusion-mcp-server

by anatsheh84

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 vmrun binary (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 build

Configuration

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

fusion_list_running

List all currently running VMs

fusion_list_all

Discover all VMs on the system (scans common directories)

fusion_get_vm_info

Get detailed info about a specific VM (OS, RAM, CPUs, IP)

fusion_start_vm

Start (power on) a VM, optionally headless

fusion_stop_vm

Stop a VM (soft/graceful or hard/forced)

fusion_suspend_vm

Suspend a running VM to disk

fusion_reset_vm

Reboot a VM (soft or hard)

fusion_get_ip

Get the guest OS IP address

fusion_list_snapshots

List all snapshots of a VM

fusion_create_snapshot

Create a new snapshot

fusion_revert_snapshot

Revert to a previous snapshot

fusion_delete_snapshot

Delete a snapshot

fusion_check_tools

Check VMware Tools status in the guest

fusion_run_in_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 tools
fusion_check_toolsCheck VMware Tools StatusB
Read-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 SnapshotA
Destructive

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 AddressA
Read-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 DetailsA
Read-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 VMsA
Read-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 VMsA
Read-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 SnapshotsA
Read-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 VMB
Destructive

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 SnapshotA
DestructiveIdempotent

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 VMA
Idempotent

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 VMA
DestructiveIdempotent

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 VMA
Idempotent

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

    A3.9/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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"