Skip to main content

VMware Workstation Pro MCP Server

VMware Workstation Pro Logo

PyPI version Python versions GitHub Issues PyPI - Downloads License

Overview

A Model Context Protocol (MCP) server for managing VMware Workstation Pro virtual machines through its REST API. This server enables seamless integration with AI assistants and other tools that support the MCP standard.

Features

  • Host Network Management: Configure and manage virtual networks
  • Virtual Machine Management: Create, modify, and delete VMs
  • Network Adapter Configuration: Customize VM network settings
  • VM Power Control: Start, stop, pause, and reset virtual machines
  • Shared Folder Management: Configure shared folders between host and VMs

System Requirements

  • VMware Workstation Pro 14+ with REST API enabled
  • Python 3.10+
  • uv (recommended) or pip

Installation

# Install with uv (recommended)
uv pip install vmware-workstation-pro-mcp-server

# Or install with pip
pip install vmware-workstation-pro-mcp-server

Setup Guide

1. Configure the VMware Workstation Pro REST API

First, set up credentials for the VMware Workstation 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

Launch the REST API service:

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 service will be available at http://localhost:8697 by default.

Windows PowerShell Start REST API

VM Network Adapters Management

3. Configure the MCP Server

Add the following configuration to your MCP client setup:

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

Available MCP Tools

list_vms

  • Description: List all available virtual machines.
  • Parameters: None
  • Returns: Array of VM objects with their IDs and basic information

get_vm_info

  • Description: Retrieve detailed information about a specific VM.
  • Parameters:
    • vm_id (string) — The ID of the virtual machine
  • Returns: Detailed VM configuration and status information

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"
  • Returns: Operation status

get_vm_power_state

  • Description: Get the current power state of a VM.
  • Parameters:
    • vm_id (string) — The ID of the virtual machine
  • Returns: Current power state of the VM

References

Star History

Star History Chart

Metadata

Release files for vmware-workstation-pro-mcp-server 0.1.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vmware-workstation-pro-mcp-server 0.1.11
File Size Uploaded
vmware_workstation_pro_mcp_server-0.1.11.tar.gz 5.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vmware-workstation-pro-mcp-server 0.1.11
File Interpreter ABI Platform
vmware_workstation_pro_mcp_server-0.1.11-py3-none-any.whl Python 3 none any Details

Total release size: 15.8 kB

Release files / vmware_workstation_pro_mcp_server-0.1.11.tar.gz

Download URL vmware_workstation_pro_mcp_server-0.1.11.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
95cd23e81957b66936a47049b18b6dd59b2ebafe44df67a560d1c5597f9d4403
BLAKE2b-256 checksum
How to use checksums
e43e50a5d326a576bfa8d23b13bf96e36d02e5d1eed7588d4d72a25631bfe2af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2025.

Transparency log

Release files / vmware_workstation_pro_mcp_server-0.1.11-py3-none-any.whl

Download URL vmware_workstation_pro_mcp_server-0.1.11-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
57dfa89b49e5463d3624c634cad24a4367b68c6b9569a35c2cd9ae0e846451e9
BLAKE2b-256 checksum
How to use checksums
7089719ab9e5deafd6508fc5ccf588cfc45b13dfe8ffdf555e3942bc4f145631
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.11 This release

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page