Skip to main content
Glama
proxmox-mcp-server

proxmox-mcp-server

by edasan0568

Proxmox MCP Server

A simple Model Context Protocol (MCP) server for managing Proxmox VE environments via the Proxmox API.

Features

  • Connects to any Proxmox host dynamically via environment variable

  • Disables SSL verification warnings for self-signed certificates (ideal for home labs)

  • Provides tools to:

    • List physical nodes

    • List virtual machines (QEMU) and containers (LXC)

    • Manage guest power states (start, stop, shutdown, status)

    • Clone VMs from templates with full Cloud-Init injection (IP, User, Password, SSH keys)

Related MCP server: ProxmoxMCP-Plus

Setup & Authentication

The server requires a Proxmox API Token. Create a token in the Proxmox GUI (Datacenter > Permissions > API Tokens) for a user with appropriate permissions (e.g., root@pam).

Set the following environment variables before running:

  • PROXMOX_HOST: The IP address or hostname of your Proxmox server (e.g., 192.168.1.100)

  • PROXMOX_TOKEN_ID: The full token ID (e.g., root@pam!mytoken)

  • PROXMOX_TOKEN_SECRET: The UUID secret of the token

Usage (via uvx)

You can run this server dynamically using uvx without installing it permanently:

PROXMOX_HOST="192.168.1.100" \
PROXMOX_TOKEN_ID="root@pam!mytoken" \
PROXMOX_TOKEN_SECRET="your-uuid-secret" \
uvx --from git+https://github.com/edasan0568/proxmox-mcp-server proxmox-mcp-server

MCP Configuration Example (MCPHub)

{
  "mcpServers": {
    "proxmox": {
      "command": "/root/.local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/edasan0568/proxmox-mcp-server",
        "proxmox-mcp-server"
      ],
      "env": {
        "PROXMOX_HOST": "192.168.1.100",
        "PROXMOX_TOKEN_ID": "root@pam!mytoken",
        "PROXMOX_TOKEN_SECRET": "your-uuid-secret"
      }
    }
  }
}

Tools Available

  1. list_nodes: List all physical nodes in the cluster.

  2. list_guests: List all VMs and Containers on a specific node.

  3. manage_guest: Start, stop, shutdown, or check status of a specific VM/CT.

  4. clone_vm: Clone a QEMU VM from a template and apply Cloud-Init configurations.

  5. create_lxc: Create an LXC Container directly from an OS template tarball and apply configurations.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers