john-broadway/proximo

Overview

Proximo is an MCP server that provides a unified interface for managing Proxmox VE, Backup Server, Mail Gateway, and Datacenter Manager. It exposes these systems through a single audited trust core, supporting planning, proving, undoing, and diagnosing operations via MCP and A2A protocols.

Best for

Best for
Developers and sysadmins managing Proxmox environments who want to automate tasks via AI agents

Use cases

• Automate Proxmox VM and container lifecycle management through MCP tools
• Integrate Proxmox backup and restore workflows into AI agent pipelines
• Audit and rollback Proxmox configuration changes with undo support

How to use

Install

uvx proximo-proxmox doctor

Tools exposed

• uvx

Tested with

Claude Desktop, Claude Code, Cursor, VS Code

Example client config

{\n  "mcpServers": {\n    "proximo": {\n      "command": "uvx",\n      "args": ["proximo-proxmox"],\n      "env": {\n        "PROXIMO_API_BASE_URL": "https://your-pve:8006/api2/json",\n        "PROXIMO_NODE": "your-node",\n        "PROXIMO_TOKEN_PATH": "/path/to/token-file"\n      }\n    }\n  }\n}

Notes

Proximo is an MCP server that provides a unified interface for managing Proxmox VE, Backup Server, Mail Gateway, and Datacenter Manager. It exposes these systems through a single audited trust core, supporting planning, proving, undoing, and diagnosing operations via MCP and A2A protocols.

8 stars on GitHub. Last updated 2026-07-13. Licensed Apache-2.0.

Use cases

• Automate Proxmox VM and container lifecycle management through MCP tools
• Integrate Proxmox backup and restore workflows into AI agent pipelines
• Audit and rollback Proxmox configuration changes with undo support

Pros

• Covers multiple Proxmox products (VE, Backup, Mail Gateway, Datacenter Manager) in one tool
• Built on an audited trust core for safer administrative operations
• Supports both MCP and A2A protocols for flexible agent integration

Cons

• Limited to Proxmox ecosystem, not useful for other virtualization platforms
• Relatively new with only 8 GitHub stars, community and documentation may be sparse
• Requires Python runtime and MCP-compatible client to function

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.