Proxmox VE (Mojood Connect)
Ask Claude about Proxmox VE guests, backups and storage; power and snapshot after a yes
- 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-mcpAdd 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 addressRequiredPVE_TOKEN_IDAPI token id (user@realm!name)RequiredPVE_TOKEN_SECRETAPI token secretRequiredPVE_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)

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents

MagicWP MCP
MCP serverRun WordPress hosting from an assistant: backups, staging, updates, PHP and domains
- Remote
- Free trial
- Cloud and infrastructure

Kubana Cloud Domains
MCP serverSearch, register and renew domains and set nameservers at Kubana Cloud from an assistant
Not checked yet- 3 tools
- Remote
- Paid
- Cloud and infrastructure

Kubana Cloud DNS Management
MCP serverCreate DNS zones, edit records and check nameserver delegation on Kubana Cloud
Not checked yet- 5 tools
- Remote
- Free
- Cloud and infrastructure