proxmox-mcp (mattoddie)
access level: configurable✔ Source-reviewed Oct 2026
We read this project's source code and tool definitions (Oct 2026). This is a code review, not a live test against real systems. Re-check after upgrades.
| Repository | https://github.com/mattoddie/proxmox-mcp |
|---|---|
| Category | Proxmox |
| Systems touched | Proxmox VE: cluster, nodes, VMs, LXC containers, storage, snapshots, backups, firewall, Ceph, HA, replication, tasks, QEMU guest agent |
| Access (as described) | configurable (read-only default) |
| License / price | MIT / free |
| GitHub stars | 2 |
| Read tools | 157 read tools across cluster, nodes, VMs, containers, storage, snapshots, backups, tasks, firewall log, Ceph, HA, replication, syslog/journal |
| Write / delete / exec tools | 110 write (start/stop, create, clone, migrate, configure, snapshot, backup), 45 delete (guests, snapshots, backups, config), 7 exec (guest-agent commands, guest file read/write, QEMU monitor); raw API escape hatch only if PROXMOX_TOOLSETS includes raw |
| Read-only mode | Yes: PROXMOX_ALLOW_WRITES, PROXMOX_ALLOW_DELETES and PROXMOX_ALLOW_EXEC all default false (deletes/exec also need writes); disallowed tools are not registered. PROXMOX_DENY_TOOLS, PROXMOX_TOOLSETS, dry_run previews, audit log, secrets redacted unless PROXMOX_ALLOW_SECRETS |
| Safety notes | Use the README path: a dedicated PVE user with a read-only (PVEAuditor) token. HTTP transport requires MCP_AUTH_TOKEN; the Docker image listens on 0.0.0.0, so keep it on LAN/VPN. Pin PROXMOX_TLS_FINGERPRINT instead of PROXMOX_VERIFY_SSL=false. v0.7.0 renamed tools, so update any PROXMOX_DENY_TOOLS list when upgrading. |
| Verified | yes (README, example.env and config source review 2026-11-21) |
| Notes | Go server, Docker or Claude Desktop .mcpb bundle. v0.7.0 (2026-11-17): 319 tools (157 read, 110 write, 45 delete, 7 exec) and 8 prompts; breaking tool renames ahead of 1.0, and strict boolean parsing (a typo like PROXMOX_VERIFY_SSL=ture now stops the server instead of silently disabling TLS checks). Very new single-maintainer project. Added 2026-11-21. |
📬 SysAdmin Agents
The SysAdmin Agents newsletter: new MCP servers, agent skills and safety notes for sysadmins. One email a week.