Skip to main content
MCP server CX Codex

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 GitHub

What 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-upgrade and show me its snapshots.
  • Run apt update on node pve1 and 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.

Proxmox VE akmalovaa Lets your agent see Proxmox VE nodes, virtual machines, containers, storage and snapshots. Read-only unless you raise the risk level. CX Codex +1 ★ 8repo stars mcp-proxmox antonio-mello-ai Connects AI assistants to Proxmox VE for VM, container, storage, and snapshot operations. Useful when infrastructure tasks should start from natural-language requests. CX Codex +1 ★ 17repo stars proxmox-admin github.com/bastos proxmox-admin — a skill that drives Proxmox VE from the terminal: builds VMs with qm, containers with pct, and configures storage and clusters. CX Codex +1 886installs proxmox poindexter12 Proxmox VE reference guide for managing VMs and LXC containers, networking, cluster configurations, and backups. CX Codex +1 1installs Proxmox AIops AIops-tools Proxmox AIops is a Claude Code MCP server that handles Proxmox VE VM and container lifecycle operations. It executes infrastructure tasks with built-in audit logs and risk-tier safeguards. CX Codex +1 ★ 5repo stars Proxmox MCP is an opinionated MCP server sergelogvinov Proxmox MCP is an opinionated MCP server wires an AI assistant into the Proxmox VE API so it can read clusters, nodes, storage, containers and VMs. Useful when clicking through the web UI gets old. CX Codex +1 ★ 5repo stars Proximo — the Proxmox MCP you can hand the keys john-broadway Proximo — the Proxmox MCP you can hand the keys is an MCP server for managing Proxmox VE, PBS, PMG, and PDM through AI agents; it checks mutation blast radius and captures pre-change state before execution. CX Codex +1 ★ 96repo stars

Project sponsors

Companies that keep this analytics open