Proxmox MCP Server

Manage Proxmox VE clusters through AI assistants - VMs, containers, and more. Its 34 documented tools cover guest, snapshot, firewall, status. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-17 · ★ 14 · #127 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Proxmox

before you install - you'll need

Set PROXMOX_HOST, PROXMOX_TOKEN_ID, PROXMOX_TOKEN_SECRET before connecting. PROXMOX_PORT, PROXMOX_VERIFY_SSL are optional or environment-specific per the README.

Claude Code

claude mcp add antonio-mello-ai-mcp-proxmox -- uvx mcp-proxmox

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "antonio-mello-ai-mcp-proxmox": {
      "command": "uvx",
      "args": [
        "mcp-proxmox"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package mcp-proxmox - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.antonio-mello-ai is GitHub-verified and matches the repo owner

03 · What Proxmox can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all cluster nodes with CPU, memory, and uptime, start a stopped VM or container, list storage pools with capacity and usage (filter by node), and create a QEMU VM with configurable CPU, memory, disk, ISO, and network.

Capability map

Tools grouped from the project's README - what Proxmox lets an agent do.

read & search

11 tools - e.g. List all cluster nodes with CPU, memory, and uptime; Detailed node info: CPU model, memory, disk, versions; List QEMU VMs (filter by node or status)

list_nodes · get_node_status · list_vms · list_containers · list_storages · list_storage_content…

Guest

10 tools - e.g. Detailed VM/CT status by VMID (auto-detects type and node); Start a stopped VM or container; Force-stop (requires confirmation)

get_guest_status · start_guest · stop_guest · shutdown_guest · reboot_guest · clone_guest…

create & write

4 tools - e.g. Create a QEMU VM with configurable CPU, memory, disk, ISO, and network; Create an LXC container from a template; Create a vzdump backup (snapshot/suspend/stop modes, zstd/lzo/gzip)

create_vm · create_container · create_backup · create_template

Snapshot

3 tools - e.g. Create a new snapshot; Rollback to a snapshot (requires confirmation); Delete a snapshot (requires confirmation)

create_snapshot · rollback_snapshot · delete_snapshot

Firewall

3 tools - e.g. List firewall rules for a VM/CT, node, or the cluster; Add a firewall rule (action, direction, protocol, port, source/dest); Delete a firewall rule by position (requires confirmation)

list_firewall_rules · add_firewall_rule · delete_firewall_rule

Restore

1 tool - e.g. Restore a VM or CT from a backup file (requires confirmation)

restore_backup

run & execute

1 tool - e.g. Run a command inside a QEMU VM via guest agent

exec_command

Configure

1 tool - e.g. Set user, password, SSH keys, IP config, and DNS on a VM

configure_cloud_init

Latest releases

v1.2.2 · 2026-08-17

Fixes · Startup crash with mcp 2.0.0 (#13). The MCP Python SDK 2.0 (2026-07-28) removed mcp.server.fastmcp; because mcp-proxmox had no upper bound on the SDK, every fresh install (uvx mcp-proxmox, uv tool install, pip…

v1.2.0 · 2026-03-10

New Tools (3) · list_templates - List all VM templates available in the cluster for cloning · create_template - Convert a stopped VM into a template (requires confirmation, irreversible) · configure_cloud_init - Set…

v1.1.0 · 2026-03-10

New Tools (4) · Firewall Rules · list_firewall_rules - List firewall rules for a VM/CT, node, or the cluster · add_firewall_rule - Create firewall rules with full parameter support (action, direction, protocol, port…

04 · Who maintains Proxmox

mcp-proxmox is maintained by antonio-mello-ai. We track 2 MCP servers from antonio-mello-ai - 2 actively maintained, 20 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from antonio-mello-ai.

mcp-pfsense Manage pfSense firewalls through AI assistants - rules, DHCP, DNS, and more ★ 6

05 · Facts

repository: github.com/antonio-mello-ai/mcp-proxmox
category: other - ranked #127 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-08-17)
registry: io.github.antonio-mello-ai/mcp-proxmox (active, first published 2026-03-10 · 2 versions)
packages: pypi:mcp-proxmox

06 · Proxmox FAQ

Is Proxmox still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-17 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Proxmox do?

How do I install Proxmox?

Run `uvx mcp-proxmox`. The README documents 5 environment variables (PROXMOX_HOST, PROXMOX_TOKEN_ID, PROXMOX_TOKEN_SECRET…) to set first. Set PROXMOX_HOST, PROXMOX_TOKEN_ID, PROXMOX_TOKEN_SECRET before connecting. PROXMOX_PORT, PROXMOX_VERIFY_SSL are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Proxmox run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Proxmox

Alternatives to Proxmox

Maintained other servers if Proxmox isn't the fit.

More MCP servers to compare · Soul MCP Server · Sitecore Server · Anythink all-in-one backend: data, auth, files, workflows, payments, APIs · XAPS MCP Server · EPANET MCP Server

More Python MCP servers · Visibly AI - SEO MCP Server · SYNAPSE CHANNEL · Garmin Local MCP · EWS Meeting MCP · see all