Proxmox VE MCP Server

Manage Proxmox VE through AI assistants

Local serverstdioTypeScript

What is the Proxmox VE MCP Server?

Manage Proxmox VE through AI assistants

What it actually does

MCP server for Proxmox VE. Manage virtual machines, containers, storage, networking, and clusters through natural language in Cursor, Claude Code, and Claude Desktop.

  • 117 tools — across 12 categories covering the Proxmox VE REST API
  • Three access tiers — (read-only, read-execute, full) for granular control
  • Category filtering — via PVE_CATEGORIES to expose only the tools you need
  • Zero HTTP dependencies — -- uses native fetch (Node 18+)
  • Self-signed cert support — via PVE_VERIFY_SSL=false
  • Docker images — for linux/amd64 and linux/arm64 on GHCR

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
pve_list_nodesList all nodes in the cluster
pve_get_node_statusGet detailed node status (CPU, memory, uptime, load)
pve_get_node_versionGet PVE version info for a node
pve_get_node_dnsGet DNS settings for a node
pve_get_node_timeGet time and timezone info for a node
pve_get_node_syslogGet system log entries from a node
pve_list_node_servicesList all system services on a node
pve_manage_node_serviceStart, stop, restart, or reload a node service
pve_list_qemu_vmsList all QEMU VMs on a node
pve_get_qemu_statusGet current VM status (CPU, memory, disk, network)
pve_get_qemu_configGet VM configuration
pve_get_qemu_rrddataGet RRD statistics over a time period
pve_list_qemu_snapshotsList all VM snapshots
pve_start_qemu_vmStart a VM

How to install the Proxmox VE MCP Server

claude mcp add pve --env PVE_BASE_URL=your-value --env PVE_TOKEN_ID=your-value --env PVE_TOKEN_SECRET=your-value --env PVE_VERIFY_SSL=your-value -- npx -y @samik081/mcp-pve

Configuration

VariableDescriptionRequired
PVE_BASE_URLEndpoint or connection string the server talks to.Yes
PVE_TOKEN_IDCredential the server authenticates with.Yes
PVE_TOKEN_SECRETCredential the server authenticates with.Yes
PVE_VERIFY_SSLConfiguration value read at startup.Optional

Example prompts to try

  • “Use Proxmox VE to pve list nodes.”
  • “Use Proxmox VE to pve get node status.”
  • “Use Proxmox VE to pve get node version.”

Frequently asked questions

Manage Proxmox VE through AI assistants Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.