Proxmox MCP — Claude Code MCP server: restore point checks
A read-only MCP server and CLI for Proxmox VE and Backup Server. It reports which client guests across your clusters have a verified recent restore point and which do not.
Open on GitHubWhat Proxmox MCP does
The server hands your agent Proxmox data with read access only. Ask about backups and you get back the guests that have a confirmed recent restore point, plus the ones missing it. Handy once you run several client clusters and checking each report by hand gets old.
The installer puts two binaries in your user bin path: proxmox-cli for the shell and proxmox-mcp for MCP. Claude, Codex and Cowork pick up the skill from SKILL.md. Run proxmox-cli --version to confirm the install, then proxmox-cli --help after authenticating.
One hard limit: do not start HTTP mode (--transport http), not even on localhost. This build verifies a token, but request size and time limits are not in place yet, and a fix is promised in a later release. If you opened a tunnel for a remote agent, shut it down. Stick with the default stdio transport.
What it helps with
- spot guests with no verified recent restore point
- check backup state across every client cluster at once
- pull a Proxmox guest list into an agent without clicking through the web UI
- confirm the CLI and MCP install with a single command
Example prompts for the agent
- List the guests in every cluster that lack a verified recent restore point
- Run
proxmox-cli --helpand tell me which commands are available - Give me the Proxmox VE guests with their latest restore points
How to install Proxmox MCP
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Proxmox MCP
How do I install Proxmox MCP in Claude Code?
Add the marketplace with /plugin marketplace add Servosity/msp-skills, then install the plugin: /plugin install proxmox@msp-skills.
What does Proxmox MCP do?
It reads Proxmox VE and Backup Server data and tells you which guests have a verified recent restore point and which do not. It ships as the proxmox-cli CLI and the proxmox-mcp MCP server.
Can I run Proxmox MCP over HTTP?
No. In this build HTTP mode checks a token but leaves request size and response time unbounded, so use stdio instead. Any tunnel you set up for a remote agent should be closed.
