Skip to main content

A MCP server for managing VMware Workstation Pro VMs via REST API

Project description

VMware Workstation Pro MCP Server

agentman

PyPI version Python versions GitHub Issues PyPI - Downloads License

An MCP (Model Context Protocol) server for managing VMware Workstation Pro virtual machines via the REST API.


Features

  • Host network management
  • Virtual machine management
  • Network adapter configuration
  • VM power control
  • Shared folder management

Prerequisites

  • VmWare Workstation 14 or higher is required (with REST API enabled)
  • Python 3.10+
  • uv (recommended) or pip

Usage

1. Configure the VMware Workstation Pro REST API

.\vmrest.exe -C
VMware Workstation REST API
Copyright (C) 2018-2025 Broadcom.
All Rights Reserved

vmrest 1.3.1 build-24832109
Username: user
New password:
Retype new password:
Processing...
Credential updated successfully

2. Start the VMware Workstation Pro REST API

cd "C:\Program Files (x86)\VMware\VMware Workstation"
.\vmrest.exe
VMware Workstation REST API
Copyright (C) 2018-2025 Broadcom.
All Rights Reserved
vmrest 1.3.1 build-24832109
-
Using the VMware Workstation UI while API calls are in progress is not recommended and may yield unexpected results
-
Serving HTTP on 127.0.0.1:8697
-
Press Ctrl+C to stop.

The API will be available at http://localhost:8697 by default.

Windows_Powershell_Start_REST_API

VM_Network_Adapters_Management


3. Configure the MCP Server

{
  "mcpServers": {
    "vmware-workstation-pro": {
      "command": "uvx",
      "args": ["vmware-workstation-pro-mcp-server"],
      "env": {
        "VMREST_USER": "your-username",
        "VMREST_PASS": "your-password"
      }
    }
  }
}

MCP Tools

list_vms

  • Description: List all available virtual machines.
  • Parameters: None

get_vm_info

  • Description: Retrieve detailed information about a specific VM.

  • Parameters:

    • vm_id (string) — The ID of the virtual machine

power_vm

  • Description: Perform a power operation on a VM.

  • Parameters:

    • vm_id (string) — The ID of the virtual machine
    • action (string) — One of: "on", "off", "suspend", "pause", "unpause", "reset"

get_vm_power_state

  • Description: Get the current power state of a VM.

  • Parameters:

    • vm_id (string) — The ID of the virtual machine

References

Star History

Star History Chart

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vmware_workstation_pro_mcp_server-0.1.7.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file vmware_workstation_pro_mcp_server-0.1.7.tar.gz.

File metadata

File hashes

Hashes for vmware_workstation_pro_mcp_server-0.1.7.tar.gz
Algorithm Hash digest
SHA256 91e3b0ccbcf350f13f0364ffebce17746eeadc65ef8f4353aacbfba6395b9811
MD5 e3bf7229547473244ac7d063a58d4295
BLAKE2b-256 68e0f9f2d375b5670fabe50448fda863030ddace97b99f9908fbf2ef3f178638

See more details on using hashes here.

Provenance

The following attestation bundles were made for vmware_workstation_pro_mcp_server-0.1.7.tar.gz:

Publisher: workflow.yml on gandli/vmware-workstation-pro-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vmware_workstation_pro_mcp_server-0.1.7-py3-none-any.whl.

File metadata

File hashes

Hashes for vmware_workstation_pro_mcp_server-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 e7f3ab8ebb6be58361662cced0431b027332f70237cb7fd5fe2180c32214a4ec
MD5 5b0d08e67c33df8decda8b111dda98d1
BLAKE2b-256 10e43848587c00190f372d251ed4d9a7c7880c7ebf844e3f608e5d3651866e94

See more details on using hashes here.

Provenance

The following attestation bundles were made for vmware_workstation_pro_mcp_server-0.1.7-py3-none-any.whl:

Publisher: workflow.yml on gandli/vmware-workstation-pro-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page