
ProxmoxMCP-Plus
Operate Proxmox VE VMs, containers, snapshots and backups from MCP or OpenAPI clients
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.7.1
- Listing updated
- today
Similar MCP servers
About ProxmoxMCP-Plus
ProxmoxMCP-Plus is an MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
Everything here goes through Proxmox API tokens, and the project puts most of its effort into guardrails around them. Command policy, approval tokens, TLS validation, bearer auth for the OpenAPI bridge and Host and Origin checks for HTTP MCP are all described in the README.
It covers VM and LXC lifecycle, snapshot create, rollback and delete, backup and restore, ISO download and cleanup, node, storage and cluster inspection, SSH-backed commands inside containers, and persistent job tracking with stable job IDs and Proxmox UPID tracking. You can run it over stdio from PyPI, as native streamable HTTP in Docker, or as an OpenAPI bridge for dashboards and no-code tools.
Tool exposure can be trimmed with an allowlist or denylist, and unknown names fail startup so a typo cannot widen access. An opt-in Code Mode replaces the full catalogue with three tools that run scripts in a sandbox, with caps of 25 tool calls and a 30-second budget.
Install
Run in a terminal
claude mcp add proxmox-mcp-plus --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_USER='<PROXMOX_USER>' --env PROXMOX_TOKEN_NAME='<PROXMOX_TOKEN_NAME>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plusAdd to claude_desktop_config.json
{
"mcpServers": {
"proxmox-mcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"proxmox-mcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"proxmox-mcp-plus": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"proxmox-mcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"proxmox-mcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PROXMOX_MCP_CONFIGOptional path to a JSON config file. If set, file config is used before environment variable fallback.PROXMOX_HOSTHostname or IP address of the Proxmox VE API endpoint.RequiredPROXMOX_USERProxmox username with realm, for example root@pam.RequiredPROXMOX_TOKEN_NAMEName of the Proxmox API token.RequiredPROXMOX_TOKEN_VALUESecret value of the Proxmox API token.RequiredPROXMOX_PORTProxmox API port. Defaults to 8006.PROXMOX_VERIFY_SSLSet to true to verify TLS certificates, or false for self-signed lab environments.PROXMOX_DEV_MODESet to true when using verify_ssl=false in a self-signed lab environment.PROXMOX_SERVICEProxmox service type. Defaults to PVE.MCP_TOOL_ALLOWLISTOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.MCP_TOOL_DENYLISTOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.LOG_LEVELServer log verbosity. Defaults to INFO.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- get_nodes
- No description
- get_vms
- No description
- get_containers
- No description
- get_storage
- No description
- proxmox_code_search
- No description
- proxmox_code_get_schema
- No description
- proxmox_code_execute
- No description
What it does
- VM and LXC lifecycle
- Start, stop and manage virtual machines and containers.
- Snapshots and backups
- Create, roll back and delete snapshots and run backup and restore workflows.
- Job tracking
- Async Proxmox tasks get stable job IDs with polling, retry, cancel and audit history.
- Tool allowlist and denylist
- Limit which tools clients see; typos fail startup.
- MCP and OpenAPI
- The same operations are reachable over MCP or an HTTP OpenAPI bridge.
Good for
- Snapshot a VM before a risky change
- Check node and storage status from an assistant
- Run guarded commands inside an LXC container
- Expose Proxmox operations to an internal dashboard via OpenAPI
ProxmoxMCP-Plus FAQ
What credentials are needed?
A Proxmox host, user, API token name and token value.
Can I restrict the tools?
Yes, with MCP_TOOL_ALLOWLIST or MCP_TOOL_DENYLIST, but not both.
How do I run it?
uvx proxmox-mcp-plus, or Docker for HTTP and OpenAPI modes.
What is Code Mode?
An opt-in mode exposing three sandboxed script tools instead of the full catalogue.
How do I add ProxmoxMCP-Plus to Claude Code?
Run this command in your terminal: claude mcp add proxmox-mcp-plus --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_USER='<PROXMOX_USER>' --env PROXMOX_TOKEN_NAME='<PROXMOX_TOKEN_NAME>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plus
What are the best alternatives to ProxmoxMCP-Plus?
The closest alternatives to ProxmoxMCP-Plus are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


