MCP.so
Sign In
P

Proxmox MCP Server

@akmalovaa

Basic information

Category

Other

Transports

stdio

Author

akmalovaa

Submitted by

Akmalov Artur

About Proxmox MCP Server

Minimal Proxmox VE MCP server for Claude — 38 tools, one Docker command, read-only by default

Proxmox MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "proxmox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXMOX_HOST",
        "-e",
        "PROXMOX_USER",
        "-e",
        "PROXMOX_PASSWORD",
        "ghcr.io/akmalovaa/proxmox-mcp:latest"
      ]
    }
  }
}

Proxmox MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Proxmox Mcp?

An MCP server for managing Proxmox VE. It exposes 38 tools covering nodes, QEMU VMs, LXC containers, storage, cluster, and snapshots. Designed for LLM agents to interact with a Proxmox environment via natural language.

How to use Proxmox Mcp?

Run the server as a single Docker container: docker run ghcr.io/akmalovaa/proxmox-mcp:latest. Pass authentication as environment variables (PROXMOX_HOST, PROXMOX_USER, plus password or token). Add an entry to your Claude configuration (claude_desktop_config.json or ~/.claude/settings.json) to register the MCP server.

Key features of Proxmox Mcp

  • Single multi-arch Docker image (amd64 + arm64)
  • Configuration via environment variables only, no files or database
  • Read-only by default; destructive operations require an explicit risk level
  • Tiny codebase: pure stdio MCP over the Proxmoxer library
  • Raw JSON output, no formatting or emoji, optimized for LLM consumption

Use cases of Proxmox Mcp

  • Manage VMs and LXC containers through conversational AI
  • Query node, storage, and cluster status from Proxmox
  • Automate snapshot creation and management across resources
  • Perform safe, read-only Proxmox inspections with default risk settings

Frequently asked questions

1

How do I authenticate to Proxmox?

Set `PROXMOX_HOST` and `PROXMOX_USER`, plus either `PROXMOX_PASSWORD` or the recommended token pair `PROXMOX_TOKEN_NAME` and `PROXMOX_TOKEN_VALUE`.

2

Is the server read-only by default?

Yes. Destructive operations are gated behind an explicit `PROXMOX_RISK_LEVEL` environment variable that must be set to a higher level.

3

What runtime is required?

Only Docker. The image is multi-arch and supports `amd64` and `arm64` hosts.

4

How do I configure it with Claude?

Add a `proxmox` entry under `mcpServers` in your Claude configuration file, using the Docker command and passing the required environment variables.

5

What format does the output use?

Raw JSON. The server returns clean data without formatting, emoji, or extra commentary, making it easy for an LLM to parse.

Comments

More Other MCP servers