Proxmox MCP Setup & Guide

{
  "id": "io.github.Servosity/proxmox-mcp",
  "type": "mcp-server",
  "version": "0.1.2",
  "displayName": "Proxmox MCP",
  "description": "Read-only Proxmox VE and Backup Server: which client guests have a verified, recent restore point.",
  "repository": {
    "url": "https://github.com/servosity/msp-skills",
    "source": "github",
    "subfolder": "skills/proxmox"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "mcpb",
        "identifier": "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.2/proxmox-mcp.mcpb",
        "version": "0.1.2",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "PROXMOX_HOST",
            "description": "Proxmox VE host name or IP (API on port 8006).",
            "isRequired": true
          },
          {
            "name": "PROXMOX_API_TOKEN",
            "description": "Proxmox VE API token USER@REALM!TOKENID=SECRET; PVEAuditor, plus Datastore.AllocateSpace and VM.Backup if backups live on PVE storage.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "PROXMOX_TLS_FINGERPRINT",
            "description": "SHA-256 fingerprint of the PVE certificate to pin (stock Proxmox certificates are self-signed)."
          },
          {
            "name": "PROXMOX_PBS_HOST",
            "description": "Optional Proxmox Backup Server host, host:port, or https://host:port (default port 8007)."
          },
          {
            "name": "PROXMOX_PBS_API_TOKEN",
            "description": "Optional Proxmox Backup Server API token USER@REALM!TOKENID:SECRET (colon before the secret).",
            "isSecret": true
          },
          {
            "name": "PROXMOX_PBS_TLS_FINGERPRINT",
            "description": "Optional SHA-256 fingerprint of the PBS certificate to pin."
          },
          {
            "name": "PROXMOX_BASE_URL",
            "description": "Full PVE API base such as https://pve1:8006/api2/json; overrides PROXMOX_HOST. Leave blank to use PROXMOX_HOST."
          },
          {
            "name": "PROXMOX_CLUSTER",
            "description": "Name of the clusters.toml entry to use by default (same as --cluster). Leave blank to run across every configured cluster."
          },
          {
            "name": "PROXMOX_CLUSTERS_FILE",
            "description": "Path to the clusters.toml that lists client clusters. Leave blank for the default. Each cluster's token variables must also be in the server's environment."
          },
          {
            "name": "PROXMOX_USER_AGENT",
            "description": "Overrides the User-Agent the CLI sends on Proxmox requests. Leave blank to use the CLI's own."
          },
          {
            "name": "PROXMOX_MCP_READ_ONLY",
            "description": "Set to 1 to drop the sync, export, workflow archive and learnings forget/reject MCP tools. The learning-store tools (teach, playbook) still write locally. Proxmox itself is never written either way. Leave blank for the full tool set."
          },
          {
            "name": "PROXMOX_MCP_HTTP_TOKEN",
            "description": "Required only when running the MCP server with --transport http (a remote or hosted deployment); the server refuses to start without it. Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses.",
            "isSecret": true
          },
          {
            "name": "PRINTING_PRESS_CLIENT_PROFILE",
            "description": "Leave blank. This connector registers no tenant-gated profile source, so the value is read but changes nothing; select client clusters with PROXMOX_CLUSTER or clusters.toml instead.",
            "isSecret": true
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.Servosity/proxmox-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Servosity%2Fproxmox-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}