ProxmoxMCP-Plus
MCP server by RekklesNA
Manage Proxmox VE virtual machines, LXC containers, snapshots, backups, storage and cluster state from an AI assistant.
Install ProxmoxMCP-Plus
Runs on your machine. Your client starts it with this command:
Needs uv (Python) on your computer. The setup steps below show where the command goes in each client.
PROXMOX_MCP_CONFIGoptional Optional 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.PROXMOX_USERProxmox username with realm, for example root@pam.PROXMOX_TOKEN_NAMEName of the Proxmox API token.PROXMOX_TOKEN_VALUEsecret Secret value of the Proxmox API token.PROXMOX_PORToptional Proxmox API port. Defaults to 8006.
Share this server
Opens this page, with the install command and setup steps.
mcp.tc/i/proxmoxmcp-plusAbout
ProxmoxMCP-Plus connects to a Proxmox VE cluster through its API and exposes VM and LXC lifecycle actions, snapshots, backups, ISO management, storage and cluster inspection, log reading, and persistent tracking of long-running tasks. It can also run guarded shell commands in guests and on nodes.
It runs locally over stdio with uvx proxmox-mcp-plus, or as a Streamable HTTP server in Docker that requires a bearer key. Access needs a Proxmox API token (host, user, token name and token value), set through environment variables or a JSON config file. Tool allowlists and denylists can limit what is exposed.
What you can do
- List nodes, VMs, containers, storage and cluster status
- Create, clone, start, stop and delete VMs and LXC containers
- Create, roll back and delete snapshots
- Create, restore and delete backups
- Run commands in VMs, containers and nodes
- Track, poll, cancel and retry long-running jobs
- Read syslog, task, cluster and firewall logs
Tools 68
list_targetsList configured Proxmox targets without exposing credentials
get_nodesList all nodes in the cluster
get_node_statusGet detailed status of a node
get_node_timeRead node clock and timezone for authentication skew diagnostics
get_node_diagnosticsRead per-node CPU, memory, storage and recent disk/network metrics
get_vmsList all virtual machines across the cluster
preflight_vm_migrationRead-only QEMU migration safety assessment
migrate_vmGuarded offline QEMU VM migration with local disks
configure_vm_serial_consoleEnable a socket-backed serial console for a stopped VM
import_cloud_imageImport existing disk image from import-enabled Proxmox storage
get_vm_configGet full configuration of a QEMU VM
set_vm_descriptionSet the Notes description of a QEMU VM
Show 56 more tools
update_vm_configUpdate VM sizing and cloud-init settings
get_vm_ip_addressesGet VM network interfaces and IPs via guest agent
get_next_vmidGet the next free VM/container ID
create_vmCreate a new virtual machine
clone_vmClone an existing virtual machine
execute_vm_commandRun a shell command in a VM via QEMU Guest Agent
start_vmStart a virtual machine
stop_vmForce stop a virtual machine
shutdown_vmGracefully shut down a virtual machine
reset_vmReset (restart) a virtual machine
delete_vmCompletely delete a virtual machine
get_storageList available storage pools
get_node_storageRead node-specific capacity, status and content capability of storage pools
get_cluster_statusGet cluster status and health
get_cluster_join_infoRead cluster join information and certificate fingerprint with credential redaction
list_jobsList persistent Proxmox task jobs
get_jobGet a persistent job by ID
poll_jobPoll a task job for current status
cancel_jobRequest cancellation of a task job
retry_jobRetry an eligible failed or cancelled job
get_containersList all LXC containers
preflight_container_migrationRead-only, fail-closed preflight checks for LXC migration
start_containerStart LXC containers
stop_containerStop LXC containers
restart_containerRestart LXC containers
update_container_resourcesUpdate CPU, memory or disk of an LXC container
create_containerCreate a new LXC container
delete_containerDelete LXC containers
migrate_containerSubmit an explicitly confirmed LXC migration and track its task
execute_container_commandRun a shell command in an LXC container via SSH
execute_node_commandRun an authorized shell command on a node via SSH
update_container_ssh_keysUpdate root authorized_keys in an LXC container
get_container_configGet full configuration of an LXC container
set_container_descriptionSet the Notes description of an LXC container
get_container_ipGet current IP information for an LXC container
list_snapshotsList snapshots for a VM or container
create_snapshotCreate a new snapshot
delete_snapshotDelete a specific snapshot
rollback_snapshotRollback to a specific snapshot
list_isosList available ISO images
list_templatesList available LXC templates
download_isoDownload an ISO image
download_templateDownload an LXC template archive to Proxmox storage
delete_isoDelete an ISO or template
list_backupsList available backups
create_backupCreate a backup of a VM or container
restore_backupRestore from a backup
delete_backupDelete a specific backup
get_node_syslogRead syslog entries from a Proxmox node
get_task_logGet the log output of a specific Proxmox task by its UPID
get_cluster_logRead recent cluster-wide log entries
get_node_firewall_logRead the host firewall log of a Proxmox node
get_guest_firewall_logRead the firewall log of a VM (qemu) or container (lxc)
update_container_networkUpdate an existing LXC network interface, preserving unspecified NIC settings.
list_bridgesList Linux/OVS bridges and permitted SDN VNets on a selected node.
reconcile_jobReconcile an uncertain retry with a verified task UPID or explicit confirmation that no task was submitted.
From the package’s own manifest, not a live connection, on 12 Oct 2026.
Example prompts
List all VMs in my Proxmox cluster and their status
Create a snapshot of VM 102 before I upgrade it
Show the IP address of LXC container 205
Back up container 110 and tell me when the job finishes
Set up
Every client starts ProxmoxMCP-Plus on your machine with the same command. Pick yours; the page remembers your choice.
Claude Code
- Run this in a terminal, in your project folder:
claude mcp add --transport stdio proxmoxmcp-plus --env "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" --env "PROXMOX_USER=<YOUR_PROXMOX_USER>" --env "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" --env "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" -- uvx proxmox-mcp-plus- Start Claude Code and type
/mcp. proxmoxmcp-plus should show as connected.
Add --scope user to make it available in every project. Replace the placeholders with your own values.
Claude Desktop
- Open Settings → Developer → Edit Config. It opens
claude_desktop_config.json. Add:
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}- Save the file and restart Claude Desktop. Replace the placeholders with your own values.
Needs uv (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.
Cursor
Add to Cursor (opens in a new tab)
Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}Needs uv (Python) on your computer. Replace the placeholders with your own values.
VS Code
Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:
{
"servers": {
"proxmoxmcp-plus": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "${input:proxmox-token-name}",
"PROXMOX_TOKEN_VALUE": "${input:proxmox-token-value}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "proxmox-token-name",
"description": "PROXMOX_TOKEN_NAME",
"password": true
},
{
"type": "promptString",
"id": "proxmox-token-value",
"description": "PROXMOX_TOKEN_VALUE",
"password": true
}
]
}Needs uv (Python) on your computer.
Devin Desktop
- Add it to
~/.config/devin/mcp_config.json(macOS and Linux) or%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}- Refresh the MCP server list in Cascade. Replace the placeholders with your own values.
Devin Desktop is the new name for Windsurf.
Codex
codex mcp add proxmoxmcp-plus --env "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" --env "PROXMOX_USER=<YOUR_PROXMOX_USER>" --env "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" --env "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" -- uvx proxmox-mcp-plusOr edit ~/.codex/config.toml directly:
[mcp_servers.proxmoxmcp-plus]
command = "uvx"
args = ["proxmox-mcp-plus"]
env = { PROXMOX_HOST = "<YOUR_PROXMOX_HOST>", PROXMOX_USER = "<YOUR_PROXMOX_USER>", PROXMOX_TOKEN_NAME = "<YOUR_PROXMOX_TOKEN_NAME>", PROXMOX_TOKEN_VALUE = "<YOUR_PROXMOX_TOKEN_VALUE>" }Needs uv (Python) on your computer. Replace the placeholders with your own values.
Gemini CLI
gemini mcp add -e "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" -e "PROXMOX_USER=<YOUR_PROXMOX_USER>" -e "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" -e "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" proxmoxmcp-plus uvx proxmox-mcp-plusThis adds it to the current project. Add -s user to use it everywhere.
Any client
Most clients that start local servers accept this shape:
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}Zed puts servers under context_servers in its settings, with the same command, args and env fields.
Needs uv (Python) on your computer. Replace the placeholders with your own values.
Embed
Show ProxmoxMCP-Plus in a README or on your site. Each embed links to this page, uses the server’s own install command, and sets no cookies. How embeds work
The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.
README badge
[](https://mcp.tc/i/proxmoxmcp-plus)<a href="https://mcp.tc/i/proxmoxmcp-plus"><img src="https://mcp.tc/i/proxmoxmcp-plus/badge.svg" alt="ProxmoxMCP-Plus on mcp.tc" height="20"></a>It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.
Website card
<script src="https://mcp.tc/w/proxmoxmcp-plus.js" async></script>The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.
iframe
<iframe src="https://mcp.tc/embed/proxmoxmcp-plus" title="ProxmoxMCP-Plus on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.
JSON
The listing as data for your own pages and tools: name, tagline, install command, tools and the “Add to” links. Any site can read it (CORS is open).
https://mcp.tc/i/proxmoxmcp-plus.jsonAI prompt
Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the ProxmoxMCP-Plus card to your site.
Add the mcp.tc card for ProxmoxMCP-Plus, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.
Put this tag where the card should appear. The card renders right before it:
```html
<script src="https://mcp.tc/w/proxmoxmcp-plus.js" async></script>
```
To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.
```html
<div data-mcptc="proxmoxmcp-plus"><a href="https://mcp.tc/i/proxmoxmcp-plus">ProxmoxMCP-Plus on mcp.tc</a></div>
```
Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.
If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).
For a README or other Markdown docs, use the badge instead:
```markdown
[](https://mcp.tc/i/proxmoxmcp-plus)
```
Reference: https://mcp.tc/embedChange history
We read the tool list in this server’s bundle manifest on GitHub every 3 hours and record what changes. Last read 18 Nov 2026, 05:30 UTC.
-
New version 0.7.1 (was 0.7.0). Read from PyPI.
-
New version 0.7.0 (was 0.6.10). Read from PyPI.
-
New version 0.6.10 (was 0.6.9). Read from PyPI.
-
New version 0.6.9 (was 0.6.8). Read from PyPI.
-
New version 0.6.8 (was 0.6.7). Read from PyPI.
-
New version 0.6.7 (was 0.6.6). Read from PyPI.
-
New version 0.6.6 (was 0.6.5). Read from PyPI.
-
5 tools added.
Details, 19 Oct 2026, 04:36 UTC
Added 5
configure_vm_serial_consoleEnable a socket-backed serial console for a stopped VM
download_templateDownload an LXC template archive to Proxmox storage
import_cloud_imageImport existing disk image from import-enabled Proxmox storage
migrate_vmGuarded offline QEMU VM migration with local disks
preflight_vm_migrationRead-only QEMU migration safety assessment
-
6 tools added.
Details, 18 Oct 2026, 07:33 UTC
Added 6
get_cluster_join_infoRead cluster join information and certificate fingerprint with credential redaction
get_node_diagnosticsRead per-node CPU, memory, storage and recent disk/network metrics
get_node_storageRead node-specific capacity, status and content capability of storage pools
get_node_timeRead node clock and timezone for authentication skew diagnostics
migrate_containerSubmit an explicitly confirmed LXC migration and track its task
preflight_container_migrationRead-only, fail-closed preflight checks for LXC migration
-
New version 0.6.3 (was 0.6.2). Read from PyPI.
-
Tracking started: 57 tools.
FAQ
Can I paste mcp.tc/i/proxmoxmcp-plus into my MCP client?
No. ProxmoxMCP-Plus runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is uvx proxmox-mcp-plus.
Does ProxmoxMCP-Plus need an API key?
Yes. It reads PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME and PROXMOX_TOKEN_VALUE from its environment, and PROXMOX_TOKEN_NAME and PROXMOX_TOKEN_VALUE are secrets. Put the values in your client’s config on your own machine, never in a shared file.
Is ProxmoxMCP-Plus a remote or a local server?
Local. Your client starts it as a process on your computer with uvx proxmox-mcp-plus, which needs uv (Python).
What can ProxmoxMCP-Plus do?
It has 68 tools, including list_targets, get_nodes and get_node_status. You can list nodes, VMs, containers, storage and cluster status, create, clone, start, stop and delete VMs and LXC containers and create, roll back and delete snapshots.
Which clients can use it?
Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.
Does mcp.tc track changes to ProxmoxMCP-Plus?
Yes. We follow the tool list in ProxmoxMCP-Plus’s bundle manifest, and its History tab shows each change we find, plus new versions and edits by its owner. Follow the listing to get an email when it changes.
Who wrote this page?
mcp.tc’s robot read ProxmoxMCP-Plus’s public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.
mcp.tc isn’t affiliated with RekklesNA. This page was built from ProxmoxMCP-Plus’s public metadata, last checked on 12 Oct 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.