ProxmoxMCP-Plus
Connects Claude and other MCP clients directly to Proxmox VE for VM and LXC lifecycle management through conversational interfaces. Exposes VM creation, snapshots, backups, ISO handling, and SSH-backed container commands as MCP tools, plus includes a dual OpenAPI surface for standard automation workflows. Tracks long-running Proxmox operations with persistent job IDs and polling. Bridges the gap between raw Proxmox API calls and production-ready operational workflows, letting you spin up containers, manage snapshots, and execute commands through natural language rather than shell scripts and API glue code.
- GitHub stars
- 649
- tools
- 29
- auth
- Secret needed
- transport
- STDIO
- env vars
- 12
- last updated
- Nov 10, 2026
Tools
29 toolsPublic tool metadata for what this MCP can expose to an agent.
get_nodesInspect the cluster by listing nodes.
Inspect the cluster by listing nodes.
No parameter schema in public metadata yet.
get_cluster_statusBest first health check after client install.
Best first health check after client install.
No parameter schema in public metadata yet.
get_storageInspect storage available to create or manage VMs and containers.
Inspect storage available to create or manage VMs and containers.
No parameter schema in public metadata yet.
get_vmsInspect VMs in the cluster.
Inspect VMs in the cluster.
No parameter schema in public metadata yet.
get_containersInspect LXC containers in the cluster.
Inspect LXC containers in the cluster.
No parameter schema in public metadata yet.
create_vmCreate a VM; long-running mutations return job_id and Proxmox task_id.
Create a VM; long-running mutations return job_id and Proxmox task_id.
No parameter schema in public metadata yet.
start_vmStart a VM.
Start a VM.
No parameter schema in public metadata yet.
stop_vmStop a VM.
Stop a VM.
No parameter schema in public metadata yet.
delete_vmDelete a VM.
Delete a VM.
No parameter schema in public metadata yet.
create_containerCreate an LXC container.
Create an LXC container.
No parameter schema in public metadata yet.
start_containerStart an LXC container.
Start an LXC container.
No parameter schema in public metadata yet.
stop_containerStop an LXC container.
Stop an LXC container.
No parameter schema in public metadata yet.
delete_containerDelete an LXC container.
Delete an LXC container.
No parameter schema in public metadata yet.
list_snapshotsList snapshots for a QEMU VM or LXC container with vm_type=qemu or vm_type=lxc.
List snapshots for a QEMU VM or LXC container with vm_type=qemu or vm_type=lxc.
No parameter schema in public metadata yet.
create_snapshotCreate a snapshot before risky changes.
Create a snapshot before risky changes.
No parameter schema in public metadata yet.
rollback_snapshotRoll back a snapshot.
Roll back a snapshot.
No parameter schema in public metadata yet.
delete_snapshotDelete a snapshot.
Delete a snapshot.
No parameter schema in public metadata yet.
execute_vm_commandRun commands inside a VM; requires QEMU Guest Agent.
Run commands inside a VM; requires QEMU Guest Agent.
No parameter schema in public metadata yet.
execute_container_commandRun commands inside a container; requires SSH to the Proxmox node.
Run commands inside a container; requires SSH to the Proxmox node.
No parameter schema in public metadata yet.
poll_jobTrack async work by job_id.
Track async work by job_id.
No parameter schema in public metadata yet.
get_jobGet details of an async job by job_id.
Get details of an async job by job_id.
No parameter schema in public metadata yet.
list_jobsList async jobs.
List async jobs.
No parameter schema in public metadata yet.
retry_jobRetry an async job.
Retry an async job.
No parameter schema in public metadata yet.
cancel_jobCancel an async job.
Cancel an async job.
No parameter schema in public metadata yet.
get_node_syslogInspect node syslog (read-only log tool).
Inspect node syslog (read-only log tool).
No parameter schema in public metadata yet.
get_cluster_logInspect cluster logs (read-only log tool).
Inspect cluster logs (read-only log tool).
No parameter schema in public metadata yet.
get_task_logInspect the log of any Proxmox UPID task (read-only log tool).
Inspect the log of any Proxmox UPID task (read-only log tool).
No parameter schema in public metadata yet.
get_node_firewall_logInspect node firewall logs (read-only log tool).
Inspect node firewall logs (read-only log tool).
No parameter schema in public metadata yet.
get_guest_firewall_logInspect guest firewall logs (read-only log tool).
Inspect guest firewall logs (read-only log tool).
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
PROXMOX_MCP_CONFIGOptional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOST*Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USER*Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAME*Name of the Proxmox API token.
PROXMOX_TOKEN_VALUE*secretSecret value of the Proxmox API token.
PROXMOX_PORTProxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLSet to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODESet to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEProxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELServer log verbosity. Defaults to INFO.
Readme
ProxmoxMCP-Plus
Operate Proxmox VE from MCP clients, AI agents, and OpenAPI tooling through one security-conscious control plane for VMs, LXCs, snapshots, backups, ISOs, container commands, and persistent long-running jobs.
Details
- Repository
- github.com/rekklesna/proxmoxmcp-plus
- Website
- github.com/RekklesNA/ProxmoxMCP-Plus
- Package
proxmox-mcp-plus- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active