Proxmox VE · gethosthewalrus — Claude Code MCP server: what it does, how to install
An MCP server that opens Proxmox VE to an AI assistant: nodes, VMs, containers, networking and firewall rules, driven through the API rather than the web UI.
no license updated 2026-10-29
Open on GitHubWhat Proxmox VE does
Your assistant gets hands on the Proxmox VE cluster through this server: nodes, QEMU virtual machines, LXC containers, storage, networking, firewall rules and high availability. It reaches both a local and a remote install, and signs in with an API token or a username and password.
Every action is its own tool. Node tools cover status, system services, interfaces, syslog and journal, tasks by UPID, S.M.A.R.T. disk data, PCI and USB devices for passthrough. VM tools handle creation, cloning, snapshots, migration, Cloud-Init, command execution through the QEMU Guest Agent, and console tickets for VNC or SPICE.
Some of it goes one way only. Turning a VM into a template cannot be undone, a disk only grows, and a VM must be stopped before it can be deleted. Get the API token or password sorted first, because nothing runs without it.
What it helps with
- check cluster node load without opening the web UI
- snapshot a VM before an upgrade
- start, stop or reboot a VM from chat
- pull a task log by its UPID
- read S.M.A.R.T. health before swapping a disk
Example prompts for the agent
- List the cluster nodes with their CPU and memory load.
- Snapshot VM 101 as
before-upgradeand show me its snapshots. - Run
apt updateon nodepve1and list the package updates it found.
How to install Proxmox VE
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 Proxmox VE
How do I install Proxmox VE in Claude Code?
Not as a Claude plugin: take the proxmox-mcp-server package from PyPI or the mcp/proxmox Docker image, then add it to your MCP client config along with the Proxmox address and the way you sign in.
What does Proxmox VE do?
It hands the assistant a set of tools for Proxmox VE: nodes, virtual machines, containers, storage, networking and firewall rules.
Do I need the QEMU Guest Agent?
Yes for vm_agent_exec, for reading and writing files inside a VM, and for setting a user password — those calls go through the guest agent. The rest talk to the Proxmox API directly.
Similar MCP servers
All MCP servers for DevOps and infrastructure →Proxmox VE by other authors comes first.