NestDaddy

Proxmox VE

io.github.mattoddie/proxmox-mcp · v0.5.1

Monitor and manage Proxmox VE clusters: VMs, containers, storage and backups. Read-only by default.

Connect Runs on your machine

Terminal
claude mcp add proxmox-mcp -e MCP_TRANSPORT=<MCP_TRANSPORT> -e PROXMOX_URL=<PROXMOX_URL> -e PROXMOX_API_TOKEN=<PROXMOX_API_TOKEN> -e PROXMOX_USERNAME=<PROXMOX_USERNAME> -e PROXMOX_PASSWORD=<PROXMOX_PASSWORD> -e PROXMOX_TLS_FINGERPRINT=<PROXMOX_TLS_FINGERPRINT> -e PROXMOX_VERIFY_SSL=<PROXMOX_VERIFY_SSL> -e PROXMOX_DEFAULT_NODE=<PROXMOX_DEFAULT_NODE> -e PROXMOX_ALLOW_WRITES=<PROXMOX_ALLOW_WRITES> -e PROXMOX_ALLOW_DELETES=<PROXMOX_ALLOW_DELETES> -e PROXMOX_ALLOW_EXEC=<PROXMOX_ALLOW_EXEC> -e PROXMOX_TOOLSETS=<PROXMOX_TOOLSETS> -e PROXMOX_AUDIT_LOG=<PROXMOX_AUDIT_LOG> -- docker run -i --rm ghcr.io/mattoddie/proxmox-mcp:0.5.1
claude_desktop_config.json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mattoddie/proxmox-mcp:0.5.1"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_USERNAME": "<PROXMOX_USERNAME>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
        "PROXMOX_TLS_FINGERPRINT": "<PROXMOX_TLS_FINGERPRINT>",
        "PROXMOX_VERIFY_SSL": "<PROXMOX_VERIFY_SSL>",
        "PROXMOX_DEFAULT_NODE": "<PROXMOX_DEFAULT_NODE>",
        "PROXMOX_ALLOW_WRITES": "<PROXMOX_ALLOW_WRITES>",
        "PROXMOX_ALLOW_DELETES": "<PROXMOX_ALLOW_DELETES>",
        "PROXMOX_ALLOW_EXEC": "<PROXMOX_ALLOW_EXEC>",
        "PROXMOX_TOOLSETS": "<PROXMOX_TOOLSETS>",
        "PROXMOX_AUDIT_LOG": "<PROXMOX_AUDIT_LOG>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mattoddie/proxmox-mcp:0.5.1"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_USERNAME": "<PROXMOX_USERNAME>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
        "PROXMOX_TLS_FINGERPRINT": "<PROXMOX_TLS_FINGERPRINT>",
        "PROXMOX_VERIFY_SSL": "<PROXMOX_VERIFY_SSL>",
        "PROXMOX_DEFAULT_NODE": "<PROXMOX_DEFAULT_NODE>",
        "PROXMOX_ALLOW_WRITES": "<PROXMOX_ALLOW_WRITES>",
        "PROXMOX_ALLOW_DELETES": "<PROXMOX_ALLOW_DELETES>",
        "PROXMOX_ALLOW_EXEC": "<PROXMOX_ALLOW_EXEC>",
        "PROXMOX_TOOLSETS": "<PROXMOX_TOOLSETS>",
        "PROXMOX_AUDIT_LOG": "<PROXMOX_AUDIT_LOG>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "proxmox-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mattoddie/proxmox-mcp:0.5.1"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "PROXMOX_URL": "<PROXMOX_URL>",
        "PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
        "PROXMOX_USERNAME": "<PROXMOX_USERNAME>",
        "PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
        "PROXMOX_TLS_FINGERPRINT": "<PROXMOX_TLS_FINGERPRINT>",
        "PROXMOX_VERIFY_SSL": "<PROXMOX_VERIFY_SSL>",
        "PROXMOX_DEFAULT_NODE": "<PROXMOX_DEFAULT_NODE>",
        "PROXMOX_ALLOW_WRITES": "<PROXMOX_ALLOW_WRITES>",
        "PROXMOX_ALLOW_DELETES": "<PROXMOX_ALLOW_DELETES>",
        "PROXMOX_ALLOW_EXEC": "<PROXMOX_ALLOW_EXEC>",
        "PROXMOX_TOOLSETS": "<PROXMOX_TOOLSETS>",
        "PROXMOX_AUDIT_LOG": "<PROXMOX_AUDIT_LOG>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
MCP_TRANSPORT
Optional
Runs the server over stdio. The image defaults to HTTP.
PROXMOX_URL
Required
Address of any node in the cluster, with the port.
PROXMOX_API_TOKEN
Optional, secret
Recommended. The whole API token as user@realm!tokenid=secret. Leave empty to use a username and password.
PROXMOX_USERNAME
Optional
Used instead of an API token, as user@realm (e.g. mcp@pve).
PROXMOX_PASSWORD
Optional, secret
The user's password, used with the username.
PROXMOX_TLS_FINGERPRINT
Optional
Recommended for Proxmox's self-signed certificate: its SHA-256 fingerprint. An https URL needs this or PROXMOX_VERIFY_SSL.
PROXMOX_VERIFY_SSL
Optional
Leave empty when you set a fingerprint. true: the certificate is publicly trusted. false: skip the check (insecure).
PROXMOX_DEFAULT_NODE
Optional
Node used when a request doesn't name one. Not needed on a single-node install.
PROXMOX_ALLOW_WRITES
Optional
Allow changes: start and stop guests, edit configuration, create VMs, snapshots and backups.
PROXMOX_ALLOW_DELETES
Optional
Also allow deleting guests, volumes, snapshots, backups and configuration. Needs writes.
PROXMOX_ALLOW_EXEC
Optional
Also allow commands and file access inside VMs through the guest agent. Needs writes.
PROXMOX_TOOLSETS
Optional
Optional comma-separated toolsets, to expose fewer tools. Empty means all (except raw).
PROXMOX_AUDIT_LOG
Optional
Optional. stderr, or a file path inside the container, to log every change as a JSON line.

Details

Packageghcr.io/mattoddie/proxmox-mcp:0.5.1 (OCI, stdio)
Packagehttps://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-darwin-arm64.mcpb (MCPB, stdio)
Packagehttps://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-darwin-amd64.mcpb (MCPB, stdio)
Packagehttps://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-windows-amd64.mcpb (MCPB, stdio)
Packagehttps://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-windows-arm64.mcpb (MCPB, stdio)
Packagehttps://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-linux-amd64.mcpb (MCPB, stdio)
Packagehttps://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-linux-arm64.mcpb (MCPB, stdio)
First published22 Oct 2026
Last updated22 Oct 2026
Registry nameio.github.mattoddie/proxmox-mcp

More files and documents servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.