mcp-utm
MCP server for managing UTM virtual machines on macOS via AppleScript.
Provides 22 tools for cloning, configuring, and controlling UTM VMs — including proper MAC address randomization for Apple Virtualization Framework clones, which enables concurrent VMs with unique network identities.
Install
# PyPI
uvx mcp-utm
# Or install globally
uv tool install mcp-utm
pip install mcp-utm
Claude Code config
{
"mcpServers": {
"utm": {
"command": "uvx",
"args": ["mcp-utm"]
}
}
}
Requirements
- macOS (uses AppleScript /
osascript) - UTM 4.6+ (download or
brew install --cask utm) - Python 3.11+
Tools
Lifecycle
| Tool | Description |
|---|---|
list_vms |
List all registered VMs with status |
get_vm |
Get status and configuration of a VM |
clone_vm |
Clone a template with unique random MAC |
start_vm |
Start a stopped or suspended VM |
stop_vm |
Stop a running VM (graceful or force) |
delete_vm |
Delete a VM permanently |
State
| Tool | Description |
|---|---|
suspend_vm |
Suspend a running VM to memory |
wait_for_vm |
Poll until VM reaches a target status |
Networking
| Tool | Description |
|---|---|
get_vm_ip |
Discover VM IP via ARP table |
set_vm_network |
Update MAC address or network mode |
Configuration
| Tool | Description |
|---|---|
set_vm_resources |
Update memory and CPU cores |
rename_vm |
Rename a VM |
set_vm_display |
Toggle dynamic resolution |
Directory Shares (VirtioFS)
| Tool | Description |
|---|---|
list_vm_shares |
List shared directories |
add_vm_share |
Add a host directory share |
remove_vm_share |
Remove a directory share |
set_vm_shares |
Replace all shares |
Drives
| Tool | Description |
|---|---|
list_vm_drives |
List attached drives |
attach_drive |
Attach an ISO or disk image |
Portability
| Tool | Description |
|---|---|
export_vm |
Export VM to a .utm file |
import_vm |
Import VM from a .utm file |
Console
| Tool | Description |
|---|---|
get_serial_port |
Get serial port address for console access |
How MAC randomization works
Apple's Virtualization Framework ignores MacAddress changes written directly to config.plist — UTM caches the config in memory. This server uses AppleScript's update configuration command which properly updates UTM's internal state, giving each clone a unique MAC and therefore a unique IP on the 192.168.64.0/24 subnet.
License
MIT
Metadata
Release files for mcp-utm 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_utm-0.1.2.tar.gz | 55.0 kB | Without provenance | Details for mcp_utm-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_utm-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for mcp_utm-0.1.2-py3-none-any.whl |
Total release size: 65.2 kB
Release files / mcp_utm-0.1.2.tar.gz
| Download URL | mcp_utm-0.1.2.tar.gz |
|---|---|
| Size | 55.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f2e25b3e774af03d368bf17e5a0db3c90d67421b5f93d14a4f8f8efc012ccddb
|
|
BLAKE2b-256 checksum How to use checksums |
63ff1b210a32d3f919885de81d17e4c84e8544d2f116a6d6264e4cf52dd26dd8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcp_utm-0.1.2-py3-none-any.whl
| Download URL | mcp_utm-0.1.2-py3-none-any.whl |
|---|---|
| Size | 10.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5468f1a6a742d028f1b821392fa934b4069fffe64c549ddacfd49ea3fa1d44a1
|
|
BLAKE2b-256 checksum How to use checksums |
178e9ea95021c60b07c89fa6681cda32a50581c4b5e156ab2661d21fbe69a09f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mcp-utm 0.1.2
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.