Proxmox MCP

stdio

Read-only Proxmox VE and Backup Server: which client guests have a verified, recent restore point.

Getting Started

npx @getmcp/cli add io.github.Servosity/proxmox-mcp

Requires Pre-built binary. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

PROXMOX_HOST
Proxmox VE host name or IP (API on port 8006).
PROXMOX_API_TOKEN
Proxmox VE API token USER@REALM!TOKENID=SECRET; PVEAuditor, plus Datastore.AllocateSpace and VM.Backup if backups live on PVE storage.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.Servosity/proxmox-mcp": {
      "command": "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.2/proxmox-mcp.mcpb",
      "env": {
        "PROXMOX_HOST": "",
        "PROXMOX_API_TOKEN": "",
        "PROXMOX_TLS_FINGERPRINT": "",
        "PROXMOX_PBS_HOST": "",
        "PROXMOX_PBS_API_TOKEN": "",
        "PROXMOX_PBS_TLS_FINGERPRINT": "",
        "PROXMOX_BASE_URL": "",
        "PROXMOX_CLUSTER": "",
        "PROXMOX_CLUSTERS_FILE": "",
        "PROXMOX_USER_AGENT": "",
        "PROXMOX_MCP_READ_ONLY": "1",
        "PROXMOX_MCP_HTTP_TOKEN": "",
        "PRINTING_PRESS_CLIENT_PROFILE": ""
      }
    }
  }
}

Claude Desktop MCP documentation