# ProxmoxMCP-Plus

> ProxmoxMCP-Plus is an MCP server for cloud and infrastructure. Operate Proxmox VE VMs, containers, snapshots and backups from MCP or OpenAPI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/rekklesna/proxmoxmcp-plus
- **MCP Registry name:** io.github.RekklesNA/proxmox-mcp-plus
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `get_nodes`
- `get_vms`
- `get_containers`
- `get_storage`
- `proxmox_code_search`
- `proxmox_code_get_schema`
- `proxmox_code_execute`

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/proxmoxmcp-plus
