Server data from the Official MCP Registry
Manage Proxmox VE clusters through AI assistants — VMs, containers, and more
Manage Proxmox VE clusters through AI assistants — VMs, containers, and more
Valid MCP server (1 strong, 4 medium validity signals). 3 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-antonio-mello-ai-mcp-proxmox": {
"args": [
"mcp-proxmox"
],
"command": "uvx"
}
}
}From the project's GitHub README.
MCP server for managing Proxmox VE clusters through AI assistants like Claude, Cursor, and Cline.
Provision, manage, and monitor your entire Proxmox infrastructure through natural language. Create VMs and containers, manage snapshots, browse storage, and more.
# Run directly with uvx (no install needed)
uvx mcp-proxmox
# Or install with pip
pip install mcp-proxmox
Set these environment variables (or create a .env file):
PROXMOX_HOST=192.168.1.100 # Your Proxmox VE host
PROXMOX_TOKEN_ID=user@pam!mcp # API token ID
PROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # API token secret
Optional:
PROXMOX_PORT=8006 # Default: 8006
PROXMOX_VERIFY_SSL=false # Default: false
VM.Audit — read VM/CT status and configVM.PowerMgmt — start/stop/shutdown/rebootVM.Snapshot — create/rollback/delete snapshotsVM.Allocate — create/delete/clone VMs and containersVM.Clone — clone operationsDatastore.Audit — list storages and browse contentDatastore.AllocateSpace — allocate disk space for new VMs/CTsSys.Audit — read node status and tasksVM.Config.Disk — resize disksVM.Config.CPU — change CPU allocationVM.Config.Memory — change memory allocationVM.Monitor — access QEMU monitor (for metrics)VM.Migrate — migrate VMs/CTs between nodesSys.Modify — manage firewall rulesVM.Config.Cloudinit — configure cloud-init parametersAdd to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"proxmox": {
"command": "uvx",
"args": ["mcp-proxmox"],
"env": {
"PROXMOX_HOST": "192.168.1.100",
"PROXMOX_TOKEN_ID": "user@pam!mcp",
"PROXMOX_TOKEN_SECRET": "your-token-secret"
}
}
}
}
Add to .claude/settings.json or ~/.claude/settings.json:
{
"mcpServers": {
"proxmox": {
"command": "uvx",
"args": ["mcp-proxmox"],
"env": {
"PROXMOX_HOST": "192.168.1.100",
"PROXMOX_TOKEN_ID": "user@pam!mcp",
"PROXMOX_TOKEN_SECRET": "your-token-secret"
}
}
}
}
Add to Cursor Settings > MCP with the same configuration as above.
| Tool | Description |
|---|---|
list_nodes | List all cluster nodes with CPU, memory, and uptime |
get_node_status | Detailed node info: CPU model, memory, disk, versions |
list_vms | List QEMU VMs (filter by node or status) |
list_containers | List LXC containers (filter by node or status) |
get_guest_status | Detailed VM/CT status by VMID (auto-detects type and node) |
| Tool | Description |
|---|---|
start_guest | Start a stopped VM or container |
stop_guest | Force-stop (requires confirmation) |
shutdown_guest | Graceful ACPI/init shutdown |
reboot_guest | Reboot (requires confirmation) |
| Tool | Description |
|---|---|
list_storages | List storage pools with capacity and usage (filter by node) |
list_storage_content | Browse ISOs, templates, backups, and disk images |
| Tool | Description |
|---|---|
create_vm | Create a QEMU VM with configurable CPU, memory, disk, ISO, and network |
create_container | Create an LXC container from a template |
clone_guest | Clone a VM or CT (full or linked clone, cross-node support) |
delete_guest | Permanently delete a stopped VM or CT (requires confirmation) |
| Tool | Description |
|---|---|
list_backups | List backup files (filter by node, storage, or VMID) |
create_backup | Create a vzdump backup (snapshot/suspend/stop modes, zstd/lzo/gzip) |
restore_backup | Restore a VM or CT from a backup file (requires confirmation) |
| Tool | Description |
|---|---|
exec_command | Run a command inside a QEMU VM via guest agent |
Note:
exec_commandrequiresqemu-guest-agentinstalled and running inside the VM. Not supported for LXC containers (Proxmox API limitation).
| Tool | Description |
|---|---|
list_snapshots | List all snapshots for a VM/CT |
create_snapshot | Create a new snapshot |
rollback_snapshot | Rollback to a snapshot (requires confirmation) |
delete_snapshot | Delete a snapshot (requires confirmation) |
| Tool | Description |
|---|---|
list_networks | List bridges, bonds, and physical interfaces on a node |
| Tool | Description |
|---|---|
resize_guest | Resize CPU, memory, and/or disk of a VM or container (requires confirmation) |
| Tool | Description |
|---|---|
get_guest_metrics | CPU, memory, network, disk I/O over time |
list_tasks | Recent tasks on a node (backups, migrations, etc.) |
| Tool | Description |
|---|---|
list_firewall_rules | List firewall rules for a VM/CT, node, or the cluster |
add_firewall_rule | Add a firewall rule (action, direction, protocol, port, source/dest) |
delete_firewall_rule | Delete a firewall rule by position (requires confirmation) |
| Tool | Description |
|---|---|
migrate_guest | Live or offline migrate a VM/CT to another node (requires confirmation) |
| Tool | Description |
|---|---|
list_templates | List all VM templates available for cloning |
create_template | Convert a stopped VM into a template (requires confirmation, irreversible) |
configure_cloud_init | Set user, password, SSH keys, IP config, and DNS on a VM |
Destructive operations (stop_guest, reboot_guest, rollback_snapshot, delete_snapshot, delete_guest, resize_guest, restore_backup, delete_firewall_rule, migrate_guest, create_template) require explicit confirm=true. The first call returns a warning describing the impact; only a second call with confirmation executes the action.
Once connected, you can ask your AI assistant:
git clone https://github.com/antonio-mello-ai/mcp-proxmox.git
cd mcp-proxmox
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
# Run tests
pytest
# Lint
ruff check src/ tests/
ruff format src/ tests/
# Type check
mypy src/
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.