whatisgithub

What is proxmox-mcp-suite?

ahmetem/proxmox-mcp-suite — explained in plain English

Analysis updated 2026-05-18

2Audience · ops devopsComplexity · 4/5LicenseSetup · moderate

In one sentence

A Claude Code plugin with 69 tools that lets Claude manage a Proxmox virtualization and backup server safely, with confirmations and an audit trail.

Mindmap

mindmap
  root((proxmox-mcp-suite))
    What it does
      Manage Proxmox via Claude
      Compact context-safe output
      Safety-gated mutations
    Tech stack
      Python
      MCP
      Proxmox VE and PBS
    Use cases
      Health checks
      Snapshots and backups
      Storage management
      Audit log review
    Audience
      Homelab operators
      DevOps admins
    Setup
      Claude Code plugin install
      Set API token env vars

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask Claude to check the overall health of a Proxmox server and its storage in one request.

USE CASE 2

Have Claude create a snapshot of a virtual machine before performing an upgrade.

USE CASE 3

Verify that a backup job for a specific container completed successfully.

USE CASE 4

Review a tamper-evident audit log of every command run on the server through Claude.

What is it built with?

PythonMCPProxmox VEProxmox Backup Serveruv

How does it compare?

ahmetem/proxmox-mcp-suite0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPython
Setup difficultymoderatemoderateeasy
Complexity4/52/52/5
Audienceops devopsgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing Proxmox VE and/or Backup Server setup plus API token credentials exported as environment variables.

GPL 3.0 requires that if you distribute a modified version of the software, you must also share your modified source code under the same license.

So what is it?

Proxmox MCP Suite lets you manage a Proxmox server setup, the kind of software people use to run virtual machines and backups on their own hardware, by talking to it through the Claude AI assistant instead of clicking through a web interface. It works as a plugin for Claude Code and gives Claude 69 separate tools split across two connected servers: one for the main virtualization platform, Proxmox VE, and one for its backup system, Proxmox Backup Server. The project's main selling point is that it was built with an AI assistant's limits in mind. Rather than dumping large, raw responses from the Proxmox system for Claude to read, it returns short, compact summaries, one call can check overall server health, and long-running tasks are tracked automatically so Claude gets the final result without repeatedly asking for updates. It covers a wide range of tasks: listing and creating virtual machines and containers, taking and restoring snapshots and backups, managing storage and disks, working with more advanced storage systems like ZFS, and running commands directly on the server or inside a virtual machine. Because many of these actions can affect real infrastructure, the suite adds safety steps. Anything that changes something requires an explicit confirmation, and anything that could destroy data requires a second, more deliberate confirmation phrase. The highest-risk actions can first run in a preview mode that shows exactly what would happen without doing it. Every command run on a server or virtual machine is also recorded in a tamper-evident log that can later be checked to confirm nothing in the log has been altered. Installing it is done through Claude Code's plugin system, and the underlying tools are fetched automatically the first time you use them, so there is no separate manual setup step. You provide your Proxmox login details as environment variables rather than typing a password directly. The project is released under the GPL 3.0 license and is not affiliated with the company behind Proxmox.

Copy-paste prompts

Prompt 1
Help me install the proxmox-ve and proxmox-backup plugins in Claude Code and set the required environment variables.
Prompt 2
Ask Claude to run a health overview on my Proxmox cluster and flag any storage that's filling up.
Prompt 3
Have Claude snapshot VM 102 as a pre-upgrade checkpoint before rebooting it.
Prompt 4
Show me how to verify the tamper-evident audit log this suite keeps for shell commands.

Frequently asked questions

What is proxmox-mcp-suite?

A Claude Code plugin with 69 tools that lets Claude manage a Proxmox virtualization and backup server safely, with confirmations and an audit trail.

What license does proxmox-mcp-suite use?

GPL 3.0 requires that if you distribute a modified version of the software, you must also share your modified source code under the same license.

How hard is proxmox-mcp-suite to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is proxmox-mcp-suite for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.