Skip to content
MCP server

Proxmox VE (Mojood Connect)

Ask Claude about Proxmox VE guests, backups and storage; power and snapshot after a yes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Proxmox VE (Mojood Connect)

Proxmox VE (Mojood Connect) is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • PVE_URLYour Proxmox VE API addressRequired
  • PVE_TOKEN_IDAPI token id (user@realm!name)Required
  • PVE_TOKEN_SECRETAPI token secretRequired
  • PVE_SAMPLE0 for real data (1 labels answers SAMPLE)

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free; no licence stated

Prices change. Check mojood.app before you buy.

Proxmox VE (Mojood Connect) 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 to Proxmox VE (Mojood Connect)

  1. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  2. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  3. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents
  4. MagicWP MCP

    MCP server

    Run WordPress hosting from an assistant: backups, staging, updates, PHP and domains

    • Remote
    • Free trial
    • Cloud and infrastructure
  5. Search, register and renew domains and set nameservers at Kubana Cloud from an assistant

    Not checked yet
    • 3 tools
    • Remote
    • Paid
    • Cloud and infrastructure
  6. Create DNS zones, edit records and check nameserver delegation on Kubana Cloud

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Cloud and infrastructure