CuratedMCP
Windsurf
PyPI

How to install ProxmoxMCP-Plus in Windsurf

Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.

Indexed, not yet reviewed

We found ProxmoxMCP-Plus in the official MCP registry. Our automated check passed on Nov 1, 2026 (it confirms the server is published and reachable), but no one at CuratedMCP has reviewed its code, permissions or credentials handling. Check what it can access before you give it keys. Scan your machine free to see every MCP server you have installed.

Steps

  1. 1Install uv (for uvx): https://docs.astral.sh/uv/
  2. 2Open ~/.codeium/windsurf/mcp_config.json
  3. 3Add the entry below. If the file already has "mcpServers", add just the inner entry
  4. 4Refresh the MCP servers list in Windsurf's Cascade panel

Configuration

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "proxmoxmcp-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": "<your-proxmox-token-value>"
      }
    }
  }
}

Replace the values in angle brackets. Optional settings are listed below.

Environment variableRequiredWhat it is
PROXMOX_MCP_CONFIGNoOptional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTYesHostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERYesProxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEYesName of the Proxmox API token.
PROXMOX_TOKEN_VALUEsecretYesSecret value of the Proxmox API token.
PROXMOX_PORTNoProxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLNoSet to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODENoSet to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICENoProxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTNoOptional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTNoOptional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELNoServer log verbosity. Defaults to INFO.

Install in other clients

About ProxmoxMCP-Plus: repo, license and check results →

Maintain ProxmoxMCP-Plus?

Claim this page to get a full CuratedMCP listing: edit your description, see listing analytics, and add our README badge. Listing is free, and a person checks every submission before it goes live. We'll pre-fill the form from the registry.

    How to install ProxmoxMCP-Plus MCP server in Windsurf | CuratedMCP