mcp-proxmox
MCP server for managing Proxmox VE clusters through AI assistants like Claude, Cursor, and Cline.
Provision, manage, and monitor your entire Proxmox infrastructure through natural language. Create VMs and containers, manage snapshots, browse storage, and more.
Quick Start
# Run directly with uvx (no install needed)
uvx mcp-proxmox
# Or install with pip
pip install mcp-proxmoxConfiguration
Set these environment variables (or create a .env file):
PROXMOX_HOST=192.168.1.100 # Your Proxmox VE host
PROXMOX_TOKEN_ID=user@pam!mcp # API token ID
PROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # API token secretOptional:
PROXMOX_PORT=8006 # Default: 8006
PROXMOX_VERIFY_SSL=false # Default: falseCreating a Proxmox API Token
- Log into your Proxmox web UI
- Go to Datacenter > Permissions > API Tokens
- Click Add and create a token for your user
- Uncheck "Privilege Separation" for full access, or assign specific permissions:
VM.Audit— read VM/CT status and configVM.PowerMgmt— start/stop/shutdown/rebootVM.Snapshot— create/rollback/delete snapshotsVM.Allocate— create/delete/clone VMs and containersVM.Clone— clone operationsDatastore.Audit— list storages and browse contentDatastore.AllocateSpace— allocate disk space for new VMs/CTsSys.Audit— read node status and tasksVM.Config.Disk— resize disksVM.Config.CPU— change CPU allocationVM.Config.Memory— change memory allocationVM.Monitor— access QEMU monitor (for metrics)VM.Migrate— migrate VMs/CTs between nodesSys.Modify— manage firewall rulesVM.Config.Cloudinit— configure cloud-init parameters
