Instant, resettable Windows and Ubuntu desktop VMs for AI agents on Apple Silicon Macs.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON â–¾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for agentpc, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
agentpc
Instant, resettable Windows and Ubuntu desktops for AI agents, on your Mac.
Website: https://agentpc.pawanpaudel.com.np
agentpc gives AI agents (Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, VS Code, or any MCP client) real desktop computers to work in: create a VM in seconds, let the agent click, type, take screenshots and run commands, then reset it to a clean state. It is a single Rust binary that runs VMs with QEMU on Apple's hypervisor and serves them to agents over MCP.
Contents
- Features
- Requirements
- Installation
- Quick start
- Using it with AI agents
- CLI reference
- Images
- Configuration
- How it works
- Troubleshooting & guest tips
- Uninstalling
- Security
- Development
- License
Features
- Instant VMs. New VMs resume from a saved snapshot of a running desktop: ready in
~1 s (Ubuntu) or ~4 s (Windows).
resetreturns a VM to a clean state just as fast. - Checkpoints. Save a running VM (disk and memory) before a risky step and return to that exact state in seconds.
- Real desktops. Windows 11 (ARM) and Ubuntu 24.04 or another release (XFCE), each with a desktop-control server agents can drive: cua-driver on both.
- One MCP server for everything. Agents create, drive, screenshot and delete VMs
themselves. Works with any MCP client;
agentpc mcp-installsets up the popular ones. - Shell and screen access. Run PowerShell or bash over SSH; take PNG screenshots straight from the hypervisor in ~40 ms, even while a guest is booting or hung.
- Files and ports. Copy files and folders between your Mac and a VM, and reach servers running inside a VM from your Mac.
- Agent-ready guests. 1280x800 desktops with a browser (Edge on Windows, Chrome on Ubuntu) and the pop-ups, update restarts and background jobs that interrupt unattended work turned off.
- Watch along. Every VM has a browser viewer, so you can see what the agent is doing.
- Any version, side by side. Run Ubuntu 22.04, 24.04 and 26.04, or several Windows 11 releases, at the same time. Each image records its OS version, source and build date.
- Local and private. Everything runs on your Mac and listens on
127.0.0.1only.
Requirements
| Requirement | Details |
|---|---|
| Hardware | Apple Silicon Mac (M1 or later; tested on M4) |
| OS | A macOS version QEMU supports: the current one and, for up to two years, the previous one (tested on macOS 15) |
| Runtime | QEMU from Homebrew (the installer handles it, installing Homebrew too if needed) |
| Memory | 4 GB per running Ubuntu VM, 8 GB per running Windows VM |
| Disk | ~10 GB per Ubuntu image, ~30 GB per Windows image (each including its snapshot) |
Installation
The installer:
- downloads the latest release and verifies its checksum,
- installs
agentpcto~/.local/bin(nosudo) and adds it to yourPATH, - installs QEMU with Homebrew if it's missing (installing Homebrew first if needed, which asks for your password once),
- registers the MCP server with the agents it finds (
agentpc mcp-install), - checks everything with
agentpc doctor.
To upgrade later, run agentpc update (or agentpc update --check to just look); rerunning the
installer works too. Installer options:
| Variable | Effect |
|---|---|
AGENTPC_VERSION=0.1.0 | Install a specific version |
AGENTPC_INSTALL_DIR=<dir> | Install somewhere other than ~/.local/bin |
AGENTPC_NO_MCP=1 | Skip registering the MCP server |
To build from source instead, see Development.
Quick start
Ubuntu:
Windows: Microsoft's license doesn't allow redistributing Windows images, so each Mac builds its own once. agentpc downloads the official Windows 11 ARM64 ISO from Microsoft (7.3 GB, checksum-verified) unless you already have one:
Then ask your agent something like:
- "Create an Ubuntu VM, open a terminal and run
uname -a." - "Reset ubuntu-1 and check that my install script works on a clean machine."
- "Open Notepad on windows-1, type a short note and show me a screenshot."
To watch a VM yourself, open the viewer URL printed by agentpc info <name>.
Using it with AI agents
agentpc is an MCP server (agentpc mcp, stdio). One server handles every VM.
Claude plugin
In Claude Code, install the agentpc plugin. It bundles the MCP server with a skill that teaches Claude when and how to use the VMs:
The plugin runs the installed agentpc binary, so install that first
(see Installation). When the plugin is installed it already registers the MCP
server for Claude Code, so agentpc mcp-install skips Claude Code to avoid a duplicate.
Other agents
Register it with every supported agent that's installed (the installer does this):
Supported: Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI and VS Code (restart Claude Desktop after registering). For any other MCP client, add:
This repository also contains project-level configs (.mcp.json, .codex/config.toml,
.cursor/mcp.json, .gemini/settings.json, .vscode/mcp.json), so agents opened in a clone
pick the server up automatically.
Tools
| Tool | Description |
|---|---|
list_vms | VMs (owner, state, size, checkpoints, viewer) and the available images with their OS versions |
create_vm | Create a VM (optionally of a given version, size, or offline) and wait until its desktop is ready. Retrying it in the same session returns the VM already created |
start_vm / stop_vm | Boot a stopped VM / shut one down cleanly |
reset_vm | Discard all changes: back to a fresh copy of the image |
checkpoint_vm / restore_vm | Save a VM's disk and memory under a label; go back to it in seconds |
delete_checkpoint | Delete one checkpoint by label; the VM is untouched |
delete_vm | Delete a VM with its disk and checkpoints |
take_screenshot | PNG screenshot from the hypervisor; save_to also writes it to a path on your Mac |
run_command | Run a command (PowerShell on Windows, bash on Ubuntu); returns exit code, stdout and stderr. A foreground run is killed at timeout (default 120 s) with partial output; background: true returns a job id for get_job_status |
get_job_status | Check a background job by its id: still running or exited (with its code), plus the tail of its log |
upload_file / download_file | Copy files or folders between your Mac and a VM |
forward_port | Reach a server running in a VM from your Mac (SSH tunnel; works even for servers bound to the guest's own 127.0.0.1) |
list_forwards / delete_forward | List a VM's active port forwards / stop one by its host port |
read_vm_log | Read the tail of a VM's qemu or serial log, for when a VM won't boot or the desktop is unreachable |
list_desktop_tools | List the desktop-control tools inside a VM |
use_desktop_tool | Call one of them: click, type, launch apps, read the UI tree, … |
VMs an MCP session created or started are stopped (never deleted) when the session ends, unless
AGENTPC_KEEP_RUNNING=1.
| Guest | Desktop | Desktop-control server |
|---|---|---|
| Windows | Windows 11 (ARM64), 1280x800, Edge | cua-driver (over SSH; Windows-MCP on images built by 0.1.0) |
| Ubuntu | Ubuntu 24.04 or another release, XFCE on X11, 1280x800, Google Chrome | cua-driver (over SSH) |
AGENTS.md has usage tips for agents.
CLI reference
VMs
Commands that act on VMs take several names (agentpc stop a b), check them all before
doing anything, and carry on past a failure (exit status 1 if any failed). Every command has
--help.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Agentpc
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/agentpc)HTML Embed
<a href="https://allmcps.com/mcp/agentpc"><img src="https://allmcps.com/api/badge/agentpc?style=directory" alt="Agentpc on AllMCPs" /></a>