# Proxmox VE

> Proxmox VE is an open-source MCP server for cloud and infrastructure. Monitor and manage Proxmox VE clusters, guests, storage and backups, read-only by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, macOS, Windows, Linux, CLI
- **Website:** https://proxmox-mcp.mattoddie.dev
- **Repository:** https://github.com/mattoddie/proxmox-mcp
- **MCP Registry name:** io.github.mattoddie/proxmox-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

With 314 tools in 19 toolsets, this open-source server is a very wide wrapper around the Proxmox VE API for version 8 and 9, on one node or many. Tool counts split into 155 read, 107 write, 45 delete and 7 exec. Toolsets cover QEMU VMs, LXC containers, the guest agent, snapshots, storage including SMART and ZFS, vzdump backups, tasks, access control, firewall, high availability, SDN, Ceph, pools, replication, notifications and hardware.

Writes, deletes and running commands inside guests are three separate switches, and unavailable tools are not registered at all. Write tools take `dry_run`, an audit log can record changes, and long operations run as Proxmox tasks that the tool waits on. Guests are addressed by VMID so single nodes need no node names. The README recommends a dedicated API token with Proxmox's own roles.

## Features

- **19 toolsets:** Cluster, nodes, VMs, containers, storage, backups, firewall, HA, SDN, Ceph and more.
- **Three safety switches:** Writes, deletes and in-guest exec are enabled separately.
- **Task-aware operations:** Waits for Proxmox tasks and returns the end of the log.
- **Dry-run and audit:** Preview changes and log every one as JSON.
- **VMID addressing:** Finds the node for a guest automatically.

## Good for

- Health-check a cluster
- Find guests with no recent backup
- List snapshots older than 30 days
- Clone a template into a new VM
- Review users and API tokens for risky permissions

## Install

### Claude Code (Terminal)

```sh
claude mcp add proxmox-mcp --env PROXMOX_URL='<PROXMOX_URL>' --env PROXMOX_API_TOKEN='<PROXMOX_API_TOKEN>' --env PROXMOX_PASSWORD='<PROXMOX_PASSWORD>' -- docker run -i --rm -e PROXMOX_URL -e PROXMOX_API_TOKEN -e PROXMOX_PASSWORD ghcr.io/mattoddie/proxmox-mcp:0.6.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXMOX_URL",
        "-e",
        "PROXMOX_API_TOKEN",
        "-e",
        "PROXMOX_PASSWORD",
        "ghcr.io/mattoddie/proxmox-mcp:0.6.0"
      ],
      "env": {
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXMOX_URL",
        "-e",
        "PROXMOX_API_TOKEN",
        "-e",
        "PROXMOX_PASSWORD",
        "ghcr.io/mattoddie/proxmox-mcp:0.6.0"
      ],
      "env": {
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "proxmox-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXMOX_URL",
        "-e",
        "PROXMOX_API_TOKEN",
        "-e",
        "PROXMOX_PASSWORD",
        "ghcr.io/mattoddie/proxmox-mcp:0.6.0"
      ],
      "env": {
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXMOX_URL",
        "-e",
        "PROXMOX_API_TOKEN",
        "-e",
        "PROXMOX_PASSWORD",
        "ghcr.io/mattoddie/proxmox-mcp:0.6.0"
      ],
      "env": {
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROXMOX_URL",
        "-e",
        "PROXMOX_API_TOKEN",
        "-e",
        "PROXMOX_PASSWORD",
        "ghcr.io/mattoddie/proxmox-mcp:0.6.0"
      ],
      "env": {
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### Which Proxmox versions work?

Proxmox VE 8 and 9.

### How do I limit what it can do?

Use a scoped API token, leave writes off and expose only chosen toolsets.

### How is it installed?

A Docker image for amd64 and arm64, plain binaries, or a Claude Desktop bundle.

### What licence?

MIT.

### Is Proxmox VE free?

Yes. Proxmox VE is open source, so you can use and self-host it for free.

### How do I add Proxmox VE to Claude Code?

Run this command in your terminal: claude mcp add proxmox-mcp --env PROXMOX_URL='<PROXMOX_URL>' --env PROXMOX_API_TOKEN='<PROXMOX_API_TOKEN>' --env PROXMOX_PASSWORD='<PROXMOX_PASSWORD>' -- docker run -i --rm -e PROXMOX_URL -e PROXMOX_API_TOKEN -e PROXMOX_PASSWORD ghcr.io/mattoddie/proxmox-mcp:0.6.0

### What are the best alternatives to Proxmox VE?

The closest alternatives to Proxmox VE are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

## Alternatives

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/proxmox-ve
