vbox-mcp
Provides tools for controlling and interacting with VirtualBox virtual machines and guests, including listing and managing VMs, taking screenshots, sending mouse and keyboard input, executing guest commands via Guest Additions, and querying guest information.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
vbox-mcp
MCP server that gives an AI agent eyes and hands inside any VirtualBox guest: screenshots, absolute mouse, keyboard (scancodes, so it works on any OS, including boot screens), power control, guest info, and command execution through Guest Additions.
Built on the VirtualBox Main API via the vboxapi Python binding that ships with
VirtualBox (XPCOM on Linux). Tested with VirtualBox 7.2.14 and a Windows 11 guest.
Install
uv venv --python /usr/bin/python3 --system-site-packages .venv # system site-packages = vboxapi
uv pip install --python .venv/bin/python -e .Related MCP server: mcp-incus-vm
Register with Claude Code
claude mcp add --scope user vbox -- /path/to/vbox-mcp/.venv/bin/python -m vbox_mcp.serverAny other MCP host: run .venv/bin/python -m vbox_mcp.server over stdio.
Optional env for guest_exec: VBOX_GUEST_USER, VBOX_GUEST_PASSWORD.
Tools
Area | Tools |
VM |
|
Screen |
|
Mouse |
|
Keyboard |
|
Guest |
|
Misc |
|
All coordinates are guest screen pixels with (0, 0) at the top-left of the monitor.
Notes
All VirtualBox calls run on one dedicated thread: XPCOM objects are thread-bound and input events from different tool calls must not interleave.
mcpis pinned to 1.x: the 2.x server speaks the 2026-07-28 protocol and Claude Code's handshake failed against it (claude mcp getreported -32022).Precise absolute mouse needs Guest Additions (or a USB tablet pointing device).
type_textsends US-layout scancodes; the guest keyboard layout should be US.On Windows,
guest_execprocesses run non-interactively (not on the user's desktop); use mouse/keyboard for GUI work.
Manual testing
.venv/bin/python scripts/call.py # list tools
.venv/bin/python scripts/call.py vm_info '{"vm":"My VM"}'
.venv/bin/python scripts/call.py --out shots screenshot '{"vm":"My VM"}'License
MIT, see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Real desktops for AI agents, on machines you choose: screenshot, type, click, hire more agents.
Cloud desktops for AI agents: create a Linux computer, see its screen, click, type and run tasks.
Linux VMs for AI agents: create VMs, run commands, edit files and open preview URLs.
Eyes and hands on real Windows PCs — observe, click, type via Glasswarp API.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI assistants to manage virtual machines, sandboxes, and dev environments through VirtualBox, Hyper-V, and Windows Sandbox, supporting VM lifecycle, ISO downloads, networking, and unattended installs.920MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control and automate Incus/QEMU virtual machines via SSH, supporting mouse/keyboard, screenshots, commands, and lifecycle management.MIT
- AlicenseNot gradedqualityBmaintenanceEnables LLMs to remotely control VirtualBox VMs and Playwright browsers on Windows, including VM lifecycle actions, in-guest commands, browser automation, window management, and service monitoring via REST API and MCP.MIT
- AlicenseCqualityCmaintenanceEnables AI applications and agents to manage Oracle VirtualBox virtual machines and run commands inside Linux and Windows guests through Bash, POSIX sh, PowerShell, and CMD.27MIT