io.github.RekklesNA/proxmox-mcp-plus

Official

by RekklesNA · Python

ProxmoxMCP-Plus

Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.

Manage Proxmox VE virtual machines, containers, snapshots, and cluster operations.

Topics

ai-agentautomationclaude-desktophomelabllmlxcmcpmodel-context-protocolopen-webuiopenapiproxmoxqemuvirtualization

Install

Configuration

Environment variables

PROXMOX_MCP_CONFIG

Optional path to a JSON config file. If set, file config is used before environment variable fallback.

PROXMOX_HOSTrequired

Hostname or IP address of the Proxmox VE API endpoint.

PROXMOX_USERrequired

Proxmox username with realm, for example root@pam.

PROXMOX_TOKEN_NAMErequired

Name of the Proxmox API token.

PROXMOX_TOKEN_VALUErequiredsecret

Secret value of the Proxmox API token.

PROXMOX_PORT

Proxmox API port. Defaults to 8006.

PROXMOX_VERIFY_SSL

Set to true to verify TLS certificates, or false for self-signed lab environments.

PROXMOX_DEV_MODE

Set to true when using verify_ssl=false in a self-signed lab environment.

PROXMOX_SERVICE

Proxmox service type. Defaults to PVE.

LOG_LEVEL

Server log verbosity. Defaults to INFO.

claude_desktop_config.json

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_MCP_CONFIG": "<YOUR_PROXMOX_MCP_CONFIG>",
        "PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
        "PROXMOX_USER": "<YOUR_PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>",
        "PROXMOX_PORT": "<YOUR_PROXMOX_PORT>",
        "PROXMOX_VERIFY_SSL": "<YOUR_PROXMOX_VERIFY_SSL>",
        "PROXMOX_DEV_MODE": "<YOUR_PROXMOX_DEV_MODE>",
        "PROXMOX_SERVICE": "<YOUR_PROXMOX_SERVICE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}