# Parallels Desktop VMs

Parallels Desktop VMs is a Claude Code MCP server for managing Parallels virtual machines on macOS. It starts guests, executes terminal commands, and captures screen output.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: Parallels
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Parallels/pdfm-mcp
- Updated: 2026-10-19
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/parallels-desktop-vms

## What it does

The server runs locally as a universal macOS executable named `pdfm-mcp`, supporting both Apple Silicon and Intel chips without needing Node or Go runtimes. Once registered, your assistant can discover configured environments by name or identifier, change power states, take snapshots, and monitor VM uptime. Launching with `--vm-id` limits tool execution to a single designated guest.

Beyond basic lifecycle controls, the integration runs shell scripts inside Windows and Linux environments, returning standard output and exit codes directly to the client. It also takes display screenshots and extracts visible on-screen text using local OCR.

Command execution inside guests requires active Parallels Tools installation. Screen capture, text observation, and keyboard operations require the target virtual machine to be powered on.

## Requirements
- Environment variables: `PDFM_MCP_VM_ID`, `PDFM_MCP_LOG_LEVEL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- control Parallels VM power states directly from the assistant interface
- run terminal commands inside Linux and Windows guest environments
- capture guest display screenshots and inspect screen text via local OCR
- automate multi-step VM provisioning and snapshot workflows

## Example prompts
- Check whether my Ubuntu virtual machine is currently running
- Capture a screenshot from the active Windows guest
- Execute a system update script inside the Debian virtual machine

## Similar
- [agent-desktop-macos](https://affpapa.org/en/nevibecode/skills/agent-desktop-macos.md) — skill · 1100 installs
- [Desktop Control](https://affpapa.org/en/nevibecode/skills/desktop-control.md) — skill · 4000 installs
- [Proxmox AIops](https://affpapa.org/en/nevibecode/mcp/proxmox-aiops.md) — MCP server · ★ 5 repo stars
- [windows-remote-desktop-connection-doctor](https://affpapa.org/en/nevibecode/skills/windows-remote-desktop-connection-doctor.md) — skill · 875 installs
- [macos-watchdog](https://affpapa.org/en/nevibecode/skills/macos-watchdog.md) — skill · 240 installs
- [release](https://affpapa.org/en/nevibecode/skills/shpigford-release.md) — skill · 106 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
