Skip to content
MCP server

ProxmoxMCP-Plus

Operate Proxmox VE VMs, containers, snapshots and backups from MCP or OpenAPI clients

Runs locallyStatus and history
Install
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.7.1
Listing updated
today

Similar MCP servers

About ProxmoxMCP-Plus

ProxmoxMCP-Plus is an MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

Everything here goes through Proxmox API tokens, and the project puts most of its effort into guardrails around them. Command policy, approval tokens, TLS validation, bearer auth for the OpenAPI bridge and Host and Origin checks for HTTP MCP are all described in the README.

It covers VM and LXC lifecycle, snapshot create, rollback and delete, backup and restore, ISO download and cleanup, node, storage and cluster inspection, SSH-backed commands inside containers, and persistent job tracking with stable job IDs and Proxmox UPID tracking. You can run it over stdio from PyPI, as native streamable HTTP in Docker, or as an OpenAPI bridge for dashboards and no-code tools.

Tool exposure can be trimmed with an allowlist or denylist, and unknown names fail startup so a typo cannot widen access. An opt-in Code Mode replaces the full catalogue with three tools that run scripts in a sandbox, with caps of 25 tool calls and a 30-second budget.

Install

Run in a terminal

claude mcp add proxmox-mcp-plus --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_USER='<PROXMOX_USER>' --env PROXMOX_TOKEN_NAME='<PROXMOX_TOKEN_NAME>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plus

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_USER": "<PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_USER": "<PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "proxmox-mcp-plus": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_USER": "<PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_USER": "<PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ],
      "env": {
        "PROXMOX_HOST": "<PROXMOX_HOST>",
        "PROXMOX_USER": "<PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PROXMOX_MCP_CONFIGOptional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_HOSTHostname or IP address of the Proxmox VE API endpoint.Required
  • PROXMOX_USERProxmox username with realm, for example root@pam.Required
  • PROXMOX_TOKEN_NAMEName of the Proxmox API token.Required
  • PROXMOX_TOKEN_VALUESecret value of the Proxmox API token.Required
  • PROXMOX_PORTProxmox API port. Defaults to 8006.
  • PROXMOX_VERIFY_SSLSet to true to verify TLS certificates, or false for self-signed lab environments.
  • PROXMOX_DEV_MODESet to true when using verify_ssl=false in a self-signed lab environment.
  • PROXMOX_SERVICEProxmox service type. Defaults to PVE.
  • MCP_TOOL_ALLOWLISTOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
  • MCP_TOOL_DENYLISTOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
  • LOG_LEVELServer log verbosity. Defaults to INFO.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_nodes
No description
get_vms
No description
get_containers
No description
get_storage
No description
proxmox_code_search
No description
proxmox_code_get_schema
No description
proxmox_code_execute
No description

What it does

VM and LXC lifecycle
Start, stop and manage virtual machines and containers.
Snapshots and backups
Create, roll back and delete snapshots and run backup and restore workflows.
Job tracking
Async Proxmox tasks get stable job IDs with polling, retry, cancel and audit history.
Tool allowlist and denylist
Limit which tools clients see; typos fail startup.
MCP and OpenAPI
The same operations are reachable over MCP or an HTTP OpenAPI bridge.

Good for

  • Snapshot a VM before a risky change
  • Check node and storage status from an assistant
  • Run guarded commands inside an LXC container
  • Expose Proxmox operations to an internal dashboard via OpenAPI

ProxmoxMCP-Plus FAQ

What credentials are needed?

A Proxmox host, user, API token name and token value.

Can I restrict the tools?

Yes, with MCP_TOOL_ALLOWLIST or MCP_TOOL_DENYLIST, but not both.

How do I run it?

uvx proxmox-mcp-plus, or Docker for HTTP and OpenAPI modes.

What is Code Mode?

An opt-in mode exposing three sandboxed script tools instead of the full catalogue.

How do I add ProxmoxMCP-Plus to Claude Code?

Run this command in your terminal: claude mcp add proxmox-mcp-plus --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_USER='<PROXMOX_USER>' --env PROXMOX_TOKEN_NAME='<PROXMOX_TOKEN_NAME>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plus

What are the best alternatives to ProxmoxMCP-Plus?

The closest alternatives to ProxmoxMCP-Plus are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers