Proxmox VE MCP Server
Connects Claude to the Proxmox VE REST API with 105 tools across 12 categories covering VMs, containers, storage, networking, and cluster operations. Three access tiers let you lock it down to read-only, add execution commands like start and stop, or go full access with create and delete. Category filtering and per-tool allowlists keep the context focused. Built on native fetch with self-signed cert support, ships as npm package or multi-arch Docker images, and supports both stdio and HTTP transports for remote MCP setups. Tested against PVE 9.0.10. Useful for managing homelab infrastructure or production clusters through natural language without switching to the web UI.
- GitHub stars
- 27
- tools
- 80
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Nov 12, 2026
Tools
80 toolsPublic tool metadata for what this MCP can expose to an agent.
pve_list_nodesList all nodes in the cluster
List all nodes in the cluster
No parameter schema in public metadata yet.
pve_get_node_statusGet detailed node status (CPU, memory, uptime, load)
Get detailed node status (CPU, memory, uptime, load)
No parameter schema in public metadata yet.
pve_get_node_rrddataGet node RRD statistics over a time period (CPU, IO wait, load, memory, network; same compact/bucketed output as guest rrddata)
Get node RRD statistics over a time period (CPU, IO wait, load, memory, network; same compact/bucketed output as guest rrddata)
No parameter schema in public metadata yet.
pve_get_node_versionGet PVE version info for a node
Get PVE version info for a node
No parameter schema in public metadata yet.
pve_get_node_dnsGet DNS settings for a node
Get DNS settings for a node
No parameter schema in public metadata yet.
pve_get_node_timeGet time and timezone info for a node
Get time and timezone info for a node
No parameter schema in public metadata yet.
pve_get_node_syslogGet system log entries from a node
Get system log entries from a node
No parameter schema in public metadata yet.
pve_list_node_servicesList all system services on a node
List all system services on a node
No parameter schema in public metadata yet.
pve_manage_node_serviceStart, stop, restart, or reload a node service
Start, stop, restart, or reload a node service
No parameter schema in public metadata yet.
pve_list_qemu_vmsList all QEMU VMs on a node
List all QEMU VMs on a node
No parameter schema in public metadata yet.
pve_get_qemu_statusGet current VM status (CPU, memory, disk, network)
Get current VM status (CPU, memory, disk, network)
No parameter schema in public metadata yet.
pve_get_qemu_configGet VM configuration
Get VM configuration
No parameter schema in public metadata yet.
pve_get_qemu_rrddataGet RRD statistics over a time period (compact table, 60 buckets by default; fields, cf, buckets, format: raw)
Get RRD statistics over a time period (compact table, 60 buckets by default; fields, cf, buckets, format: raw)
No parameter schema in public metadata yet.
pve_list_qemu_snapshotsList all VM snapshots
List all VM snapshots
No parameter schema in public metadata yet.
pve_start_qemu_vmStart a VM
Start a VM
No parameter schema in public metadata yet.
pve_stop_qemu_vmStop a VM (immediate)
Stop a VM (immediate)
No parameter schema in public metadata yet.
pve_shutdown_qemu_vmGracefully shut down a VM
Gracefully shut down a VM
No parameter schema in public metadata yet.
pve_reboot_qemu_vmReboot a VM
Reboot a VM
No parameter schema in public metadata yet.
pve_suspend_qemu_vmSuspend a VM
Suspend a VM
No parameter schema in public metadata yet.
pve_resume_qemu_vmResume a suspended VM
Resume a suspended VM
No parameter schema in public metadata yet.
pve_reset_qemu_vmReset a VM (hard)
Reset a VM (hard)
No parameter schema in public metadata yet.
pve_migrate_qemu_vmMigrate a VM to another node
Migrate a VM to another node
No parameter schema in public metadata yet.
pve_create_qemu_vmCreate a new VM
Create a new VM
No parameter schema in public metadata yet.
pve_delete_qemu_vmDelete a VM and all its data
Delete a VM and all its data
No parameter schema in public metadata yet.
pve_update_qemu_configUpdate VM configuration
Update VM configuration
No parameter schema in public metadata yet.
pve_clone_qemu_vmClone a VM
Clone a VM
No parameter schema in public metadata yet.
pve_create_qemu_snapshotCreate a VM snapshot
Create a VM snapshot
No parameter schema in public metadata yet.
pve_delete_qemu_snapshotDelete a VM snapshot
Delete a VM snapshot
No parameter schema in public metadata yet.
pve_rollback_qemu_snapshotRollback a VM to a snapshot
Rollback a VM to a snapshot
No parameter schema in public metadata yet.
pve_list_lxc_containersList all LXC containers on a node
List all LXC containers on a node
No parameter schema in public metadata yet.
pve_get_lxc_statusGet current container status
Get current container status
No parameter schema in public metadata yet.
pve_get_lxc_configGet container configuration
Get container configuration
No parameter schema in public metadata yet.
pve_get_lxc_rrddataGet RRD statistics over a time period (compact table, 60 buckets by default; fields, cf, buckets, format: raw)
Get RRD statistics over a time period (compact table, 60 buckets by default; fields, cf, buckets, format: raw)
No parameter schema in public metadata yet.
pve_list_lxc_snapshotsList all container snapshots
List all container snapshots
No parameter schema in public metadata yet.
pve_start_lxc_containerStart a container
Start a container
No parameter schema in public metadata yet.
pve_stop_lxc_containerStop a container (immediate)
Stop a container (immediate)
No parameter schema in public metadata yet.
pve_shutdown_lxc_containerGracefully shut down a container
Gracefully shut down a container
No parameter schema in public metadata yet.
pve_reboot_lxc_containerReboot a container
Reboot a container
No parameter schema in public metadata yet.
pve_suspend_lxc_containerSuspend (freeze) a container
Suspend (freeze) a container
No parameter schema in public metadata yet.
pve_resume_lxc_containerResume (unfreeze) a container
Resume (unfreeze) a container
No parameter schema in public metadata yet.
pve_create_lxc_containerCreate a new container
Create a new container
No parameter schema in public metadata yet.
pve_delete_lxc_containerDelete a container and all its data
Delete a container and all its data
No parameter schema in public metadata yet.
pve_update_lxc_configUpdate container configuration
Update container configuration
No parameter schema in public metadata yet.
pve_clone_lxc_containerClone a container
Clone a container
No parameter schema in public metadata yet.
pve_create_lxc_snapshotCreate a container snapshot
Create a container snapshot
No parameter schema in public metadata yet.
pve_delete_lxc_snapshotDelete a container snapshot
Delete a container snapshot
No parameter schema in public metadata yet.
pve_rollback_lxc_snapshotRollback a container to a snapshot
Rollback a container to a snapshot
No parameter schema in public metadata yet.
pve_list_storageList all configured storage backends
List all configured storage backends
No parameter schema in public metadata yet.
pve_get_storage_configGet storage backend configuration
Get storage backend configuration
No parameter schema in public metadata yet.
pve_list_node_storageList available storage on a node with usage info
List available storage on a node with usage info
No parameter schema in public metadata yet.
pve_get_storage_statusGet storage status and usage on a node
Get storage status and usage on a node
No parameter schema in public metadata yet.
pve_list_storage_contentList storage content (images, ISOs, backups); filter by vmid, or mode latest / summary per guest
List storage content (images, ISOs, backups); filter by vmid, or mode latest / summary per guest
No parameter schema in public metadata yet.
pve_pull_oci_imagePull an OCI container image into a storage's template cache (PVE 9.1+)
Pull an OCI container image into a storage's template cache (PVE 9.1+)
No parameter schema in public metadata yet.
pve_create_storageCreate a new storage backend
Create a new storage backend
No parameter schema in public metadata yet.
pve_update_storageUpdate storage configuration
Update storage configuration
No parameter schema in public metadata yet.
pve_delete_storageDelete a storage backend
Delete a storage backend
No parameter schema in public metadata yet.
pve_get_cluster_statusGet cluster status (membership, quorum)
Get cluster status (membership, quorum)
No parameter schema in public metadata yet.
pve_list_cluster_resourcesList all cluster resources with optional type filter
List all cluster resources with optional type filter
No parameter schema in public metadata yet.
pve_get_next_vmidGet the next available VMID
Get the next available VMID
No parameter schema in public metadata yet.
pve_get_cluster_logGet recent cluster log entries
Get recent cluster log entries
No parameter schema in public metadata yet.
pve_get_cluster_optionsGet datacenter options
Get datacenter options
No parameter schema in public metadata yet.
pve_list_cluster_backup_infoList guests not covered by backup jobs
List guests not covered by backup jobs
No parameter schema in public metadata yet.
pve_get_cluster_ha_statusGet HA manager status
Get HA manager status
No parameter schema in public metadata yet.
pve_list_cluster_replicationList all replication jobs
List all replication jobs
No parameter schema in public metadata yet.
pve_bulk_start_guestsBulk start VMs/containers cluster-wide (PVE 9.1+)
Bulk start VMs/containers cluster-wide (PVE 9.1+)
No parameter schema in public metadata yet.
pve_bulk_shutdown_guestsBulk shutdown VMs/containers cluster-wide (PVE 9.1+)
Bulk shutdown VMs/containers cluster-wide (PVE 9.1+)
No parameter schema in public metadata yet.
pve_bulk_suspend_guestsBulk suspend VMs cluster-wide (PVE 9.1+)
Bulk suspend VMs cluster-wide (PVE 9.1+)
No parameter schema in public metadata yet.
pve_bulk_migrate_guestsBulk migrate VMs/containers to a target node (PVE 9.1+)
Bulk migrate VMs/containers to a target node (PVE 9.1+)
No parameter schema in public metadata yet.
pve_update_cluster_optionsUpdate datacenter options
Update datacenter options
No parameter schema in public metadata yet.
pve_list_usersList all users
List all users
No parameter schema in public metadata yet.
pve_get_userGet user details
Get user details
No parameter schema in public metadata yet.
pve_list_rolesList all roles and privileges
List all roles and privileges
No parameter schema in public metadata yet.
pve_list_groupsList all user groups
List all user groups
No parameter schema in public metadata yet.
pve_list_aclsList all ACL entries
List all ACL entries
No parameter schema in public metadata yet.
pve_list_domainsList authentication domains/realms
List authentication domains/realms
No parameter schema in public metadata yet.
pve_list_user_tokensList the API tokens of a user
List the API tokens of a user
No parameter schema in public metadata yet.
pve_create_userCreate a new user
Create a new user
No parameter schema in public metadata yet.
pve_update_userUpdate user properties
Update user properties
No parameter schema in public metadata yet.
pve_delete_userDelete a user
Delete a user
No parameter schema in public metadata yet.
pve_update_aclGrant or revoke ACL permissions
Grant or revoke ACL permissions
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 languageConfiguration
PVE_BASE_URL*URL of the Proxmox VE instance (e.g. https://pve.example.com:8006)
PVE_TOKEN_ID*secretProxmox VE API token ID (e.g. user@pam!token-name)
PVE_TOKEN_SECRET*secretProxmox VE API token secret
Readme
MCP PVE
MCP server for Proxmox VE. Manage virtual machines, containers, storage, networking, and clusters through natural language in Cursor, Claude Code, and Claude Desktop.
Features
Details
- Repository
- github.com/samik081/mcp-pve
- Package
@samik081/mcp-pve- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active