Mcp Proxmox
Brings Proxmox VE cluster management into Claude through the Proxmox API. You get lifecycle controls (start, stop, shutdown), VM and container provisioning, snapshot management, backup and restore, storage browsing, and cloud-init configuration. It also handles firewall rules, live migration between nodes, disk resizing, and command execution via qemu-guest-agent. Destructive operations require explicit confirmation flags to prevent accidents. Useful if you're already running Proxmox and want to manage infrastructure through natural language instead of switching to the web UI or writing shell scripts. Configuration is straightforward with API tokens, and it works with uvx so you can skip the installation step entirely.
- GitHub stars
- 18
- tools
- 37
- transport
- STDIO
- last updated
- Nov 4, 2026
Tools
37 toolsPublic tool metadata for what this MCP can expose to an agent.
list_nodesList all cluster nodes with CPU, memory, and uptime
List all cluster nodes with CPU, memory, and uptime
No parameter schema in public metadata yet.
get_node_statusDetailed node info: CPU model, memory, disk, versions
Detailed node info: CPU model, memory, disk, versions
No parameter schema in public metadata yet.
list_vmsList QEMU VMs (filter by node or status)
List QEMU VMs (filter by node or status)
No parameter schema in public metadata yet.
list_containersList LXC containers (filter by node or status)
List LXC containers (filter by node or status)
No parameter schema in public metadata yet.
get_guest_statusDetailed VM/CT status by VMID (auto-detects type and node)
Detailed VM/CT status by VMID (auto-detects type and node)
No parameter schema in public metadata yet.
start_guestStart a stopped VM or container
Start a stopped VM or container
No parameter schema in public metadata yet.
stop_guestForce-stop (requires confirmation)
Force-stop (requires confirmation)
No parameter schema in public metadata yet.
shutdown_guestGraceful ACPI/init shutdown
Graceful ACPI/init shutdown
No parameter schema in public metadata yet.
reboot_guestReboot (requires confirmation)
Reboot (requires confirmation)
No parameter schema in public metadata yet.
list_storagesList storage pools with capacity and usage (filter by node)
List storage pools with capacity and usage (filter by node)
No parameter schema in public metadata yet.
list_storage_contentBrowse ISOs, templates, backups, and disk images
Browse ISOs, templates, backups, and disk images
No parameter schema in public metadata yet.
create_vmCreate a QEMU VM with configurable CPU, memory, disk, ISO, and network
Create a QEMU VM with configurable CPU, memory, disk, ISO, and network
No parameter schema in public metadata yet.
create_containerCreate an LXC container from a template
Create an LXC container from a template
No parameter schema in public metadata yet.
clone_guestClone a VM or CT (full or linked clone, cross-node support)
Clone a VM or CT (full or linked clone, cross-node support)
No parameter schema in public metadata yet.
delete_guestPermanently delete a stopped VM or CT (requires confirmation)
Permanently delete a stopped VM or CT (requires confirmation)
No parameter schema in public metadata yet.
list_backupsList backup files (filter by node, storage, or VMID)
List backup files (filter by node, storage, or VMID)
No parameter schema in public metadata yet.
create_backupCreate a vzdump backup (snapshot/suspend/stop modes, zstd/lzo/gzip)
Create a vzdump backup (snapshot/suspend/stop modes, zstd/lzo/gzip)
No parameter schema in public metadata yet.
restore_backupRestore a VM or CT from a backup file (requires confirmation)
Restore a VM or CT from a backup file (requires confirmation)
No parameter schema in public metadata yet.
exec_commandRun a command inside a QEMU VM via guest agent
Run a command inside a QEMU VM via guest agent
No parameter schema in public metadata yet.
vm_screenshotCapture a PNG screenshot of a QEMU VM's display (login prompt, boot messages, installer, GUI)
Capture a PNG screenshot of a QEMU VM's display (login prompt, boot messages, installer, GUI)
No parameter schema in public metadata yet.
vm_send_keySend a key or combination to a VM console (requires confirmation)
Send a key or combination to a VM console (requires confirmation)
No parameter schema in public metadata yet.
vm_send_textType ASCII text into a VM console (US layout; requires confirmation)
Type ASCII text into a VM console (US layout; requires confirmation)
No parameter schema in public metadata yet.
list_snapshotsList all snapshots for a VM/CT
List all snapshots for a VM/CT
No parameter schema in public metadata yet.
create_snapshotCreate a new snapshot
Create a new snapshot
No parameter schema in public metadata yet.
rollback_snapshotRollback to a snapshot (requires confirmation)
Rollback to a snapshot (requires confirmation)
No parameter schema in public metadata yet.
delete_snapshotDelete a snapshot (requires confirmation)
Delete a snapshot (requires confirmation)
No parameter schema in public metadata yet.
list_networksList bridges, bonds, and physical interfaces on a node
List bridges, bonds, and physical interfaces on a node
No parameter schema in public metadata yet.
resize_guestResize CPU, memory, and/or disk of a VM or container (requires confirmation)
Resize CPU, memory, and/or disk of a VM or container (requires confirmation)
No parameter schema in public metadata yet.
get_guest_metricsCPU, memory, network, disk I/O over time
CPU, memory, network, disk I/O over time
No parameter schema in public metadata yet.
list_tasksRecent tasks on a node (backups, migrations, etc.)
Recent tasks on a node (backups, migrations, etc.)
No parameter schema in public metadata yet.
list_firewall_rulesList firewall rules for a VM/CT, node, or the cluster
List firewall rules for a VM/CT, node, or the cluster
No parameter schema in public metadata yet.
add_firewall_ruleAdd a firewall rule (action, direction, protocol, port, source/dest)
Add a firewall rule (action, direction, protocol, port, source/dest)
No parameter schema in public metadata yet.
delete_firewall_ruleDelete a firewall rule by position (requires confirmation)
Delete a firewall rule by position (requires confirmation)
No parameter schema in public metadata yet.
migrate_guestLive or offline migrate a VM/CT to another node (requires confirmation)
Live or offline migrate a VM/CT to another node (requires confirmation)
No parameter schema in public metadata yet.
list_templatesList all VM templates available for cloning
List all VM templates available for cloning
No parameter schema in public metadata yet.
create_templateConvert a stopped VM into a template (requires confirmation, irreversible)
Convert a stopped VM into a template (requires confirmation, irreversible)
No parameter schema in public metadata yet.
configure_cloud_initSet user, password, SSH keys, IP config, and DNS on a VM
Set user, password, SSH keys, IP config, and DNS on a VM
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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-proxmox
Configuration
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 secret
Optional:
PROXMOX_PORT=8006 # Default: 8006
PROXMOX_VERIFY_SSL=false # Default: false
Creating a Proxmox API Token
Details
- Repository
- github.com/felhen-ai/mcp-proxmox
- Package
mcp-proxmox- Transport
- STDIO
- Registry
- MCP registry, active