Parallels Desktop VMs — Claude Code MCP server: setup and tools
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.
MIT ★ 11 updated 2026-10-19
Open on GitHubWhat Parallels Desktop VMs 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.
What it helps with
- 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 for the agent
- 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
How to install Parallels Desktop VMs
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Parallels Desktop VMs
How to install Parallels Desktop VMs in Claude Code?
Install the cask with brew install --cask Parallels/tap/pdfm-mcp. Then attach the server by running claude mcp add --transport stdio --scope user pdfm-mcp -- "$(brew --prefix)/bin/pdfm-mcp".
What does Parallels Desktop VMs do?
It exposes Parallels hypervisor operations to MCP clients on macOS. The assistant can inspect VM lists, start or pause guests, read screen content, and trigger commands inside virtual systems.
What is required to run Parallels Desktop VMs?
You need macOS and an active installation of Parallels Desktop. Running commands inside guests requires Parallels Tools, while display reading and keystrokes require a running virtual machine.