A Node.js-based Model Context Protocol (MCP) server for managing Proxmox VE hypervisors: nodes, QEMU VMs, and LXC containers, with configurable permission levels and Terraform/OpenTofu export.
🚀 Proxmox MCP Server (Node.js Edition) is an MCP project maintained in the gilby125/mcp-proxmox repository. The maintainer describes its purpose as “A Node.js-based Model Context Protocol (MCP) server for managing Proxmox VE hypervisors: nodes, QEMU VMs, and LXC containers, with configurable permission levels and Terraform/OpenTofu export”. Read the project documentation for the complete scope.
The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME, PROXMOX_TOKEN_VALUE, PROXMOX_ALLOW_ELEVATED. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| node | export only guests on this node |
| vmid | export a single VM/container |
| include_provider | include terraform {} / provider {} scaffolding (default true) |
| proxmox_get_nodes | List cluster nodes with status and resources |
| proxmox_get_node_status | Detailed node status (needs elevated + Sys.Audit) |
| proxmox_get_vms | List VMs/containers, filterable by node and type |
| proxmox_get_vm_status | Detailed status for one VM/container |
| proxmox_get_storage | List storage pools and usage |
| proxmox_get_cluster_status | Cluster health overview |
| proxmox_list_templates | List LXC templates on a storage |
| proxmox_get_next_vmid | Next free VM/container ID |
| proxmox_get_vm_config | Full configuration of a VM/container (cores, memory, disks, network, cloud-init) |
| proxmox_get_task_status | Status of a task by UPID; optionally wait until it finishes |
| proxmox_whoami | Identity the token authenticates as and its effective permissions |
| proxmox_get_rrd_data | Historical CPU/memory/disk/network time series (node or guest) |
| proxmox_get_pools | Resource pools and their members |
| proxmox_get_ha_resources | High-availability resources and desired state |
| proxmox_get_firewall_rules | Firewall rules at cluster / node / guest level |
| proxmox_generate_terraform | Generate Terraform/OpenTofu HCL from existing guests |
| Category | Tools |
| Create | proxmox_create_vm, proxmox_create_lxc |
| Lifecycle | proxmox_start_, proxmox_stop_, proxmox_reboot_, proxmox_shutdown_, proxmox_pause_vm, proxmox_resume_vm |
| Snapshots | proxmox_create_snapshot_, proxmox_list_snapshots_, proxmox_rollback_snapshot_, proxmox_delete_snapshot_ |
| Backups | proxmox_create_backup_, proxmox_list_backups, proxmox_restore_backup_, proxmox_delete_backup |
| Disks | proxmox_add_disk_vm, proxmox_add_mountpoint_lxc, proxmox_resize_disk_, proxmox_remove_disk_vm, proxmox_remove_mountpoint_lxc, proxmox_move_disk_ |
| Network | proxmox_add_network_, proxmox_update_network_, proxmox_remove_network_ |
| Cloud-init | proxmox_set_cloudinit (QEMU) |
{
"mcpServers": {
"proxmox": {
"command": "node",
"args": [
"/absolute/path/to/mcp-proxmox/index.js"
],
"env": {
"PROXMOX_HOST": "your-proxmox-ip",
"PROXMOX_USER": "root@pam",
"PROXMOX_TOKEN_NAME": "YOUR_PROXMOX_TOKEN_NAME",
"PROXMOX_TOKEN_VALUE": "YOUR_PROXMOX_TOKEN_VALUE",
"PROXMOX_ALLOW_ELEVATED": "false"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| PROXMOX_HOST | Declared in the maintainer’s client configuration. | Yes |
| PROXMOX_USER | Declared in the maintainer’s client configuration. | Optional |
| PROXMOX_TOKEN_NAME | Declared in the maintainer’s client configuration. | Optional |
| PROXMOX_TOKEN_VALUE | Declared in the maintainer’s client configuration. | Yes |
| PROXMOX_ALLOW_ELEVATED | Declared in the maintainer’s client configuration. | Optional |
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.
AWS Labs' official server suite — current AWS docs, CDK guidance, cost analysis and service tools.
Cloud browsers for AI agents — automation sessions that run in Browserbase's fleet, not on your machine.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.
Dashboards, Prometheus and Loki queries, incidents and alerts — observability by conversation.
kubectl with a conversational interface — inspect pods, read logs, diagnose clusters and manage workloads.