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)

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