mcp-proxmox — Claude Code MCP server: what it does, how to install
Connects AI assistants to Proxmox VE for VM, container, storage, and snapshot operations. Useful when infrastructure tasks should start from natural-language requests.
claude mcp add mcp-proxmox -- uvx mcp-proxmoxWhat mcp-proxmox does
mcp-proxmox exposes Proxmox VE controls to an AI assistant. It can inspect cluster nodes, QEMU VMs, and LXC containers, change guest power state, create clones, manage snapshots and backups, browse storage, and inspect network or firewall settings.
The server can run with uvx mcp-proxmox or be installed with pip install mcp-proxmox. Its connection uses PROXMOX_HOST, PROXMOX_TOKEN_ID, and PROXMOX_TOKEN_SECRET; PROXMOX_PORT and PROXMOX_VERIFY_SSL are available for the port and SSL check. The Proxmox token needs the permissions required by the operations you want to perform.
exec_command needs qemu-guest-agent running inside the guest and works only with QEMU VMs, not LXC containers. Console tools use VM.Console; text input follows a US keyboard layout and does not handle Cyrillic characters.
What it helps with
- inspect nodes and guest status
- provision or clone VMs and LXC containers
- create backups and restore guests
- browse storage pools and network interfaces
- run commands inside a QEMU VM
Example prompts for the agent
- Show the Proxmox cluster nodes with their CPU and memory status.
- Create a QEMU VM with the requested CPU, memory, disk, ISO, and network settings.
- Create a snapshot for this VM and list its recent Proxmox tasks.
How to install mcp-proxmox
Platform CLI
claude mcp add mcp-proxmox -- uvx mcp-proxmoxuvx runs the command named after the package; if the README names another one, use uvx --from mcp-proxmox <command>
Platform CLI
codex mcp add mcp-proxmox -- uvx mcp-proxmoxuvx runs the command named after the package; if the README names another one, use uvx --from mcp-proxmox <command>
Config file
{
"mcpServers": {
"mcp-proxmox": {
"command": "uvx",
"args": [
"mcp-proxmox"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-proxmox <command>
Config file
{
"servers": {
"mcp-proxmox": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-proxmox"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-proxmox <command>
Platform CLI
gemini mcp add mcp-proxmox uvx mcp-proxmoxuvx runs the command named after the package; if the README names another one, use uvx --from mcp-proxmox <command>
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 mcp-proxmox
How do I install mcp-proxmox in Claude Code?
Run claude mcp add mcp-proxmox -- uvx mcp-proxmox, then set PROXMOX_HOST, PROXMOX_TOKEN_ID, and PROXMOX_TOKEN_SECRET.
What does mcp-proxmox do?
It connects an AI assistant to Proxmox VE and exposes controls for VMs, LXC containers, snapshots, backups, storage, networks, and related tasks.
Can it run commands inside an LXC container?
No. exec_command relies on qemu-guest-agent and supports QEMU VMs only.
