The Proxmox MCP Server provides comprehensive management of Proxmox VE clusters through the Model Context Protocol, enabling programmatic control over virtualization infrastructure with 85+ tools.
Key Capabilities:
Virtual Machine (QEMU) & Container (LXC) Management: Full lifecycle control including list, start, stop, shutdown, reboot, suspend, resume; configuration management; snapshot operations (create, list, rollback, delete); cloning and migration between nodes
Node Management: List nodes, get status/version/time/DNS/subscription information; manage services (start, stop, restart, reload); read system logs (syslog/journal); start/stop all VMs/containers on a node; generate diagnostic reports
Storage Management: List storage, check status, browse content, upload ISOs/templates, download files from URLs, delete volumes; manage physical disks (list, SMART data, initialize GPT, wipe)
Network Configuration: Create and manage interfaces (bridges, bonds, VLANs, OVS); configure IP addressing, gateways, bond modes (balance-rr, active-backup, LACP); enable VLAN-aware bridges; apply or revert network changes
User & Access Control: Create, update, and delete users, groups, and roles; manage ACLs with path-based permissions; configure authentication domains
Cluster Operations: Get cluster status, list resources and tasks, configure cluster options (console, keyboard, language, migration settings), allocate next VMID, read cluster logs
High Availability (HA): View HA status, manage HA resources with failover policies, create HA groups with node priorities and failback configurations
Backup & Replication: Create, configure, and manage backup jobs with scheduling, compression modes (snapshot, suspend, stop), and notifications; manage replication jobs for data synchronization
Firewall & Security: Configure cluster-wide firewall options and policies, manage firewall rules, security groups, IP sets, and aliases
Task Management: View and filter running tasks (by VMID, user, type, errors), get task status and logs, stop tasks
Certificate Management: List certificates, manage ACME accounts, order Let's Encrypt certificates
Provides comprehensive management of Proxmox VE infrastructure including virtual machines (QEMU), LXC containers, storage, cluster resources, access control, high availability, backups, and network configuration through the Proxmox API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Proxmox MCP Serverlist all running virtual machines on node pve1"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Proxmox MCP Server
MCP (Model Context Protocol) server for the Proxmox VE API. Manage VMs and containers through Claude Code.
Features
55 essential tools for day-to-day Proxmox management:
Nodes: List nodes, get status and version
QEMU VMs: List, status, start/stop/reboot, snapshots, clone, migrate
LXC Containers: List, status, start/stop/reboot, snapshots, clone, migrate
Storage: List storage, browse content, check status
Tasks: View running tasks and logs
Quick Install
Prerequisites
Node.js 18+
jq (
sudo apt install jq)Proxmox VE 7.0+ with API token
Manual Installation
Add to ~/.claude.json:
Tools
Nodes
Tool | Description |
| List all nodes |
| Get node status |
| Get node version |
QEMU VMs
Tool | Description |
| List all VMs on a node |
| Get VM details |
| Get VM configuration |
| Update VM configuration |
| Get current VM status |
| Start VM |
| Stop VM (hard) |
| Shutdown VM (graceful) |
| Reboot VM |
| Suspend VM |
| Resume VM |
| List snapshots |
| Create snapshot |
| Get snapshot details |
| Delete snapshot |
| Rollback to snapshot |
| Clone VM |
| Migrate VM to another node |
LXC Containers
Tool | Description |
| List all containers on a node |
| Get container details |
| Get container configuration |
| Update container configuration |
| Get current container status |
| Start container |
| Stop container |
| Shutdown container |
| Reboot container |
| Suspend container |
| Resume container |
| List snapshots |
| Create snapshot |
| Get snapshot details |
| Delete snapshot |
| Rollback to snapshot |
| Clone container |
| Migrate container |
Storage
Tool | Description |
| List storage on a node |
| Get storage status |
| List storage content |
Tasks
Tool | Description |
| List tasks |
| Get task status |
| Get task log |
Example Usage
"List all VMs on node pve"
"Start VM 100 on node pve"
"Create a snapshot of container 101 called before-update"
"Show storage status on node pve"
"What tasks are running on node pve?"
Creating an API Token
Proxmox UI → Datacenter → Permissions → API Tokens → Add
Select user (e.g.,
root@pam), enter Token ID (e.g.,claude)Uncheck "Privilege Separation" for full access
Copy the secret immediately!
License
MIT