We and selected third parties use cookies or similar technologies for technical purposes and, with your consent, to analyze how the site is used.

You can freely give, refuse or withdraw your consent at any time.

ProxmoxMCP-Plus

MCP server by RekklesNA

Manage Proxmox VE virtual machines, LXC containers, snapshots, backups, storage and cluster state from an AI assistant.

Runs locally (Runs on your machine: its page has the install command)Runs with uvxNeeds an API key

Install ProxmoxMCP-Plus

Runs on your machine. Your client starts it with this command:

uvx proxmox-mcp-plus

Needs uv (Python) on your computer. The setup steps below show where the command goes in each client.

  • PROXMOX_MCP_CONFIG optional Optional path to a JSON config file. If set, file config is used before environment variable fallback.
  • PROXMOX_HOST Hostname or IP address of the Proxmox VE API endpoint.
  • PROXMOX_USER Proxmox username with realm, for example root@pam.
  • PROXMOX_TOKEN_NAME Name of the Proxmox API token.
  • PROXMOX_TOKEN_VALUE secret Secret value of the Proxmox API token.
  • PROXMOX_PORT optional Proxmox API port. Defaults to 8006.

Share this server

Opens this page, with the install command and setup steps.

mcp.tc/i/proxmoxmcp-plus

About

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_targets

    List configured Proxmox targets without exposing credentials

  • get_nodes

    List all nodes in the cluster

  • get_node_status

    Get detailed status of a node

  • get_node_time

    Read node clock and timezone for authentication skew diagnostics

  • get_node_diagnostics

    Read per-node CPU, memory, storage and recent disk/network metrics

  • get_vms

    List all virtual machines across the cluster

  • preflight_vm_migration

    Read-only QEMU migration safety assessment

  • migrate_vm

    Guarded offline QEMU VM migration with local disks

  • configure_vm_serial_console

    Enable a socket-backed serial console for a stopped VM

  • import_cloud_image

    Import existing disk image from import-enabled Proxmox storage

  • get_vm_config

    Get full configuration of a QEMU VM

  • set_vm_description

    Set the Notes description of a QEMU VM

Show 56 more tools
  • update_vm_config

    Update VM sizing and cloud-init settings

  • get_vm_ip_addresses

    Get VM network interfaces and IPs via guest agent

  • get_next_vmid

    Get the next free VM/container ID

  • create_vm

    Create a new virtual machine

  • clone_vm

    Clone an existing virtual machine

  • execute_vm_command

    Run a shell command in a VM via QEMU Guest Agent

  • start_vm

    Start a virtual machine

  • stop_vm

    Force stop a virtual machine

  • shutdown_vm

    Gracefully shut down a virtual machine

  • reset_vm

    Reset (restart) a virtual machine

  • delete_vm

    Completely delete a virtual machine

  • get_storage

    List available storage pools

  • get_node_storage

    Read node-specific capacity, status and content capability of storage pools

  • get_cluster_status

    Get cluster status and health

  • get_cluster_join_info

    Read cluster join information and certificate fingerprint with credential redaction

  • list_jobs

    List persistent Proxmox task jobs

  • get_job

    Get a persistent job by ID

  • poll_job

    Poll a task job for current status

  • cancel_job

    Request cancellation of a task job

  • retry_job

    Retry an eligible failed or cancelled job

  • get_containers

    List all LXC containers

  • preflight_container_migration

    Read-only, fail-closed preflight checks for LXC migration

  • start_container

    Start LXC containers

  • stop_container

    Stop LXC containers

  • restart_container

    Restart LXC containers

  • update_container_resources

    Update CPU, memory or disk of an LXC container

  • create_container

    Create a new LXC container

  • delete_container

    Delete LXC containers

  • migrate_container

    Submit an explicitly confirmed LXC migration and track its task

  • execute_container_command

    Run a shell command in an LXC container via SSH

  • execute_node_command

    Run an authorized shell command on a node via SSH

  • update_container_ssh_keys

    Update root authorized_keys in an LXC container

  • get_container_config

    Get full configuration of an LXC container

  • set_container_description

    Set the Notes description of an LXC container

  • get_container_ip

    Get current IP information for an LXC container

  • list_snapshots

    List snapshots for a VM or container

  • create_snapshot

    Create a new snapshot

  • delete_snapshot

    Delete a specific snapshot

  • rollback_snapshot

    Rollback to a specific snapshot

  • list_isos

    List available ISO images

  • list_templates

    List available LXC templates

  • download_iso

    Download an ISO image

  • download_template

    Download an LXC template archive to Proxmox storage

  • delete_iso

    Delete an ISO or template

  • list_backups

    List available backups

  • create_backup

    Create a backup of a VM or container

  • restore_backup

    Restore from a backup

  • delete_backup

    Delete a specific backup

  • get_node_syslog

    Read syslog entries from a Proxmox node

  • get_task_log

    Get the log output of a specific Proxmox task by its UPID

  • get_cluster_log

    Read recent cluster-wide log entries

  • get_node_firewall_log

    Read the host firewall log of a Proxmox node

  • get_guest_firewall_log

    Read the firewall log of a VM (qemu) or container (lxc)

  • update_container_network

    Update an existing LXC network interface, preserving unspecified NIC settings.

  • list_bridges

    List Linux/OVS bridges and permitted SDN VNets on a selected node.

  • reconcile_job

    Reconcile 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

  1. 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
  1. 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

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "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>"
      }
    }
  }
}
  1. 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

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "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:

.vscode/mcp.json
{
  "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

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "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>"
      }
    }
  }
}
  1. 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-plus

Or edit ~/.codex/config.toml directly:

config.toml
[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-plus

This 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

Badge preview, lightBadge preview, dark
Markdown
[![ProxmoxMCP-Plus on mcp.tc](https://mcp.tc/i/proxmoxmcp-plus/badge.svg)](https://mcp.tc/i/proxmoxmcp-plus)
HTML
<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

HTML
<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

HTML
<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.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the ProxmoxMCP-Plus card to your site.

Markdown
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
[![ProxmoxMCP-Plus on mcp.tc](https://mcp.tc/i/proxmoxmcp-plus/badge.svg)](https://mcp.tc/i/proxmoxmcp-plus)
```

Reference: https://mcp.tc/embed

Change 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.

Follow ProxmoxMCP-Plus and we’ll email you when something changes.

  1. , Automatic check

    New version 0.7.1 (was 0.7.0). Read from PyPI.

  2. , Automatic check

    New version 0.7.0 (was 0.6.10). Read from PyPI.

  3. , Automatic check

    New version 0.6.10 (was 0.6.9). Read from PyPI.

  4. , Automatic check

    New version 0.6.9 (was 0.6.8). Read from PyPI.

  5. , Automatic check

    New version 0.6.8 (was 0.6.7). Read from PyPI.

  6. , Automatic check

    New version 0.6.7 (was 0.6.6). Read from PyPI.

  7. , Automatic check

    New version 0.6.6 (was 0.6.5). Read from PyPI.

  8. , Automatic check

    5 tools added.

    Details, 19 Oct 2026, 04:36 UTC

    Added 5

    • configure_vm_serial_console

      Enable a socket-backed serial console for a stopped VM

    • download_template

      Download an LXC template archive to Proxmox storage

    • import_cloud_image

      Import existing disk image from import-enabled Proxmox storage

    • migrate_vm

      Guarded offline QEMU VM migration with local disks

    • preflight_vm_migration

      Read-only QEMU migration safety assessment

  9. , Automatic check

    6 tools added.

    Details, 18 Oct 2026, 07:33 UTC

    Added 6

    • get_cluster_join_info

      Read cluster join information and certificate fingerprint with credential redaction

    • get_node_diagnostics

      Read per-node CPU, memory, storage and recent disk/network metrics

    • get_node_storage

      Read node-specific capacity, status and content capability of storage pools

    • get_node_time

      Read node clock and timezone for authentication skew diagnostics

    • migrate_container

      Submit an explicitly confirmed LXC migration and track its task

    • preflight_container_migration

      Read-only, fail-closed preflight checks for LXC migration

  10. , Automatic check

    New version 0.6.3 (was 0.6.2). Read from PyPI.

  11. , Automatic check

    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.