# Proxmox VE (Mojood Connect)

> Proxmox VE (Mojood Connect) is an open-source MCP server for cloud and infrastructure. Ask Claude about Proxmox VE guests, backups and storage; power and snapshot after a yes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://mojood.app/connect
- **Repository:** https://github.com/askmojood/proxmox-mcp
- **MCP Registry name:** io.github.askmojood/proxmox-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

Questions like which guests no backup job covers, whose backups are overdue or which production VMs are stopped are answered from the Proxmox REST API with an API token. The server works with Proxmox VE 8 or 9 and was built by Mojood Connect as a working demo.

Six tools are listed. Four are read-only: overview, find_guests, guest_details and needs_attention, which flags unprotected guests, overdue backups, stopped production guests, old snapshots, filling storage and memory shortage. Two change things: power_guest starts, shuts down or reboots a VM or container, and snapshot_guest takes a snapshot. Both return a plain summary and a one-time code first, and the change only happens when the same request returns with that code within 10 minutes. No tool deletes a guest, restores a backup or rolls back a snapshot.

The README describes a least-privilege token role and a script that builds a local Proxmox VE 9.2 test setup with sample guests for a made-up company, which needs an Apple Silicon Mac. The package mojood-proxmox-mcp runs over stdio and needs PVE_URL, PVE_TOKEN_ID and PVE_TOKEN_SECRET.

## Features

- **Fleet overview:** Nodes, storage use, running and stopped guests and backup jobs.
- **Needs-attention report:** Finds unbacked guests, overdue backups and filling storage.
- **Guest details:** Cores, disks, snapshots, last backup and recent tasks.
- **Confirmed changes:** Power and snapshot actions need a one-time code first.
- **No destructive tools:** Cannot delete guests, restore backups or roll back snapshots.
- **Sample lab setup:** Script builds a local Proxmox with sample guests.

## Good for

- Find VMs that no backup job covers
- Check why a production guest is stopped
- Take a snapshot before a change, with a note on who asked
- Review storage and memory pressure across nodes

## Install

### Claude Code (Terminal)

```sh
claude mcp add proxmox-mcp --env PVE_URL='<PVE_URL>' --env PVE_TOKEN_ID='<PVE_TOKEN_ID>' --env PVE_TOKEN_SECRET='<PVE_TOKEN_SECRET>' -- uvx mojood-proxmox-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "uvx",
      "args": [
        "mojood-proxmox-mcp"
      ],
      "env": {
        "PVE_URL": "<PVE_URL>",
        "PVE_TOKEN_ID": "<PVE_TOKEN_ID>",
        "PVE_TOKEN_SECRET": "<PVE_TOKEN_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "uvx",
      "args": [
        "mojood-proxmox-mcp"
      ],
      "env": {
        "PVE_URL": "<PVE_URL>",
        "PVE_TOKEN_ID": "<PVE_TOKEN_ID>",
        "PVE_TOKEN_SECRET": "<PVE_TOKEN_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "proxmox-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mojood-proxmox-mcp"
      ],
      "env": {
        "PVE_URL": "<PVE_URL>",
        "PVE_TOKEN_ID": "<PVE_TOKEN_ID>",
        "PVE_TOKEN_SECRET": "<PVE_TOKEN_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "uvx",
      "args": [
        "mojood-proxmox-mcp"
      ],
      "env": {
        "PVE_URL": "<PVE_URL>",
        "PVE_TOKEN_ID": "<PVE_TOKEN_ID>",
        "PVE_TOKEN_SECRET": "<PVE_TOKEN_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "uvx",
      "args": [
        "mojood-proxmox-mcp"
      ],
      "env": {
        "PVE_URL": "<PVE_URL>",
        "PVE_TOKEN_ID": "<PVE_TOKEN_ID>",
        "PVE_TOKEN_SECRET": "<PVE_TOKEN_SECRET>"
      }
    }
  }
}
```

## Tools

- `overview`: Nodes, storage use, guests and backup jobs
- `find_guests`: Find VMs and containers by name, id, tag or state
- `guest_details`: Details for one guest
- `needs_attention`: Guests and storage that need attention
- `power_guest`: Start, shut down or reboot a guest after confirmation
- `snapshot_guest`: Take a snapshot after confirmation

## FAQ

### What does it need?

A Proxmox VE 8 or 9 API address and an API token, passed as PVE_URL, PVE_TOKEN_ID and PVE_TOKEN_SECRET.

### Can it delete or restore anything?

No. The README says no tool deletes a guest, restores a backup or rolls back a snapshot.

### How are changes confirmed?

A first call returns a summary and a one-time code, and the change runs only when the code comes back within 10 minutes.

### Where do changes get logged?

Proxmox's own task log records them under the token's user.

### Can I try it without a real cluster?

Yes. The repository includes a script that creates a local test Proxmox with sample guests.

### Is Proxmox VE (Mojood Connect) free?

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

### How do I add Proxmox VE (Mojood Connect) to Claude Code?

Run this command in your terminal: claude mcp add proxmox-mcp --env PVE_URL='<PVE_URL>' --env PVE_TOKEN_ID='<PVE_TOKEN_ID>' --env PVE_TOKEN_SECRET='<PVE_TOKEN_SECRET>' -- uvx mojood-proxmox-mcp

### What are the best alternatives to Proxmox VE (Mojood Connect)?

The closest alternatives to Proxmox VE (Mojood Connect) 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.
- [Kubana Cloud App Platform](https://ai-powered.com/mcp/kubana-cloud-app-platform): Kubana Cloud App Platform is a freemium MCP server for cloud and infrastructure.

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