Proxmox VE MCP Server

Manage Proxmox VE nodes, VMs, containers, storage and snapshots. Read-only by default. Its 40 documented tools cover container, snapshot, rrd, task. It runs locally over stdio via the published package.

People who work with container, snapshot and rrd and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-02 · ★ 2 · #62 OF 120 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Proxmox VE

before you install - you'll need

Set PROXMOX_HOST, PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_USER, PROXMOX_RISK_LEVEL, PROXMOX_PASSWORD, PROXMOX_TOOLS_ALLOW, PROXMOX_MCP_TRANSPORT, PROXMOX_MCP_HOST, PROXMOX_MCP_ALLOWED_HOSTS before connecting.

Claude Code

claude mcp add akmalovaa-proxmox-mcp -- uvx proxmox-ve-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "akmalovaa-proxmox-mcp": {
      "command": "uvx",
      "args": [
        "proxmox-ve-mcp"
      ]
    }
  }
}

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 · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

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

registry namespace io.github.akmalovaa is GitHub-verified and matches the repo owner

03 · What Proxmox VE 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 status, CPU, memory, uptime, log output from a task, list all VMs, optionally filter by node, and list all snapshots of a VM.

Capability map

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

read & search

8 tools - e.g. List all cluster nodes with status, CPU, memory, uptime; List all VMs, optionally filter by node; Current VM status (running/stopped, CPU, memory)

list_nodes · list_vms · get_vm_status · get_vm_config · get_vm_network_interfaces · get_vm_rrd_data…

Node

7 tools - e.g. Detailed node metrics (CPU, memory, disk, load, kernel); Network interfaces on a node; Physical disks on a node

get_node_status · get_node_networks · get_node_disks · get_node_services · get_node_updates · get_node_rrd_data…

Container

7 tools - e.g. Current container status; Container configuration; IP addresses of a running container

get_container_status · get_container_config · get_container_interfaces · get_container_rrd_data · list_container_snapshots · start_container…

Snapshot

6 tools - e.g. Create a snapshot; Delete a snapshot; Rollback to a snapshot

create_vm_snapshot · delete_vm_snapshot · rollback_vm_snapshot · create_container_snapshot · delete_container_snapshot · rollback_container_snapshot

Task

2 tools - e.g. Status of a specific task by UPID; Log output from a task

get_task_status · get_task_log

run & execute

2 tools - e.g. Start a VM; Force-stop a VM - annotated destructive, unsaved guest state is lost

start_vm · stop_vm

Shutdown

2 tools - e.g. Graceful ACPI shutdown with timeout; Graceful shutdown with timeout

shutdown_vm · shutdown_container

Reboot

2 tools - e.g. Reboot via ACPI; Reboot a container

reboot_vm · reboot_container

Latest releases

2.3.0 · 2026-09-01

Add streamable-http transport, health endpoints, tier/annotation split

2.2.0 · 2026-09-01

Sentry MCP traces

2.1.0 · 2026-08-31

Highlights · Guest IP addresses. get_vm_network_interfaces (via the QEMU guest agent) and · get_container_interfaces return the addresses a guest actually holds - something · no tool exposed before. · Failures are…

04 · Who maintains Proxmox VE

Proxmox VE is maintained by akmalovaa. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/akmalovaa/proxmox-mcp
website: https://github.com/akmalovaa/proxmox-mcp
category: DevOps & monitoring - ranked #62 of 120 actively-maintained DevOps & monitoring servers as of 2026-09-18.
release cadence: 4 releases in the last 90 days (latest 2026-09-01)
registry: io.github.akmalovaa/proxmox-mcp (active, first published 2026-09-01 · 3 versions)
packages: pypi:proxmox-ve-mcp · oci:ghcr.io/akmalovaa/proxmox-mcp:2.3.0

06 · Proxmox VE FAQ

Is Proxmox VE still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-02 and it shipped 4 releases in the last 90 days. We re-verify nightly.

What can Proxmox VE do?

With this server connected, an agent can list all cluster nodes with status, CPU, memory, uptime, log output from a task, list all VMs, optionally filter by node, and list all snapshots of a VM.

How do I install Proxmox VE?

Run `uvx proxmox-ve-mcp`. The README documents 10 environment variables (PROXMOX_HOST, PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE…) to set first. Set PROXMOX_HOST, PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_USER, PROXMOX_RISK_LEVEL, PROXMOX_PASSWORD, PROXMOX_TOOLS_ALLOW, PROXMOX_MCP_TRANSPORT, PROXMOX_MCP_HOST, PROXMOX_MCP_ALLOWED_HOSTS before connecting. You can also paste the ready-made client config above.

Does Proxmox VE 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 VE

Alternatives to Proxmox VE

Maintained DevOps & monitoring servers if Proxmox VE isn't the fit.

Pairs well with

Servers that cover what Proxmox VE doesn't - only shown when the pairing reason fits the companion.

More DevOps & monitoring MCP servers · Arduino MCP Server (akshatnerella) · Mcpspend · DOS - the trust substrate for agent fleets · Safe SSH MCP · Telemetry Server

More Python MCP servers · ZulipChat MCP Server · Healthclaw Guardrails · Google News & Trends MCP · Kasbah MCP · Docvet · see all