Skip to content
MCP server

Proxmox MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.8
Listing updated
4 days ago

About Proxmox MCP

Proxmox MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add proxmox-mcp --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_API_TOKEN='<PROXMOX_API_TOKEN>' --env PROXMOX_PBS_API_TOKEN='<PROXMOX_PBS_API_TOKEN>' --env PROXMOX_MCP_HTTP_TOKEN='<PROXMOX_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PBS_API_TOKEN": "<PROXMOX_PBS_API_TOKEN>",
        "PROXMOX_MCP_HTTP_TOKEN": "<PROXMOX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PBS_API_TOKEN": "<PROXMOX_PBS_API_TOKEN>",
        "PROXMOX_MCP_HTTP_TOKEN": "<PROXMOX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "proxmox-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PBS_API_TOKEN": "<PROXMOX_PBS_API_TOKEN>",
        "PROXMOX_MCP_HTTP_TOKEN": "<PROXMOX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PBS_API_TOKEN": "<PROXMOX_PBS_API_TOKEN>",
        "PROXMOX_MCP_HTTP_TOKEN": "<PROXMOX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PBS_API_TOKEN": "<PROXMOX_PBS_API_TOKEN>",
        "PROXMOX_MCP_HTTP_TOKEN": "<PROXMOX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Configuration

  • PROXMOX_HOSTProxmox VE host name or IP (API on port 8006).Required
  • PROXMOX_API_TOKENProxmox VE API token USER@REALM!TOKENID=SECRET; PVEAuditor, plus Datastore.AllocateSpace and VM.Backup if backups live on PVE storage.Required
  • PROXMOX_TLS_FINGERPRINTSHA-256 fingerprint of the PVE certificate to pin (stock Proxmox certificates are self-signed).
  • PROXMOX_PBS_HOSTOptional Proxmox Backup Server host, host:port, or https://host:port (default port 8007).
  • PROXMOX_PBS_API_TOKENOptional Proxmox Backup Server API token USER@REALM!TOKENID:SECRET (colon before the secret).
  • PROXMOX_PBS_TLS_FINGERPRINTOptional SHA-256 fingerprint of the PBS certificate to pin.
  • PROXMOX_BASE_URLFull PVE API base such as https://pve1:8006/api2/json; overrides PROXMOX_HOST. Leave blank to use PROXMOX_HOST.
  • PROXMOX_CLUSTERName of the clusters.toml entry to use by default (same as --cluster). Leave blank to run across every configured cluster.
  • PROXMOX_CLUSTERS_FILEPath 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.
  • PROXMOX_USER_AGENTOverrides the User-Agent the CLI sends on Proxmox requests. Leave blank to use the CLI's own.
  • PROXMOX_MCP_READ_ONLYSet 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.
  • PROXMOX_MCP_HTTP_TOKENRequired 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.
  • PRINTING_PRESS_CLIENT_PROFILELeave 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.
  • PROXMOX_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API, store writes are off, and sync and workflow archive refuse to run. Leave blank to keep the local store.

Pricing

Open source

Proxmox MCP FAQ

Is Proxmox MCP free?

Yes. Proxmox MCP is open source, so you can use and self-host it for free.

How do I add Proxmox MCP to Claude Code?

Run this command in your terminal: claude mcp add proxmox-mcp --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_API_TOKEN='<PROXMOX_API_TOKEN>' --env PROXMOX_PBS_API_TOKEN='<PROXMOX_PBS_API_TOKEN>' --env PROXMOX_MCP_HTTP_TOKEN='<PROXMOX_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.8/proxmox-mcp.mcpb