Proxmoxmcp Plus MCP Server

An enhanced Python-based Model Context Protocol (MCP) server for interacting with Proxmox virtualization platforms. This project extends

Local serverstdioPython

What is the Proxmoxmcp Plus MCP Server?

An enhanced Python-based Model Context Protocol (MCP) server for interacting with Proxmox virtualization platforms. This project extends

What the server does

  • Full integration with Cline and Open WebUI
  • Built with the official MCP SDK
  • Secure token-based authentication with Proxmox
  • Complete VM lifecycle management (create, start, stop, reset, shutdown, delete)
  • VM console command execution
  • LXC container management support

Credentials and setup notes

  • UV package manager (recommended) - Python 3.9 or higher - Git - Access to a Proxmox server with API token credentials Before starting, ensure you have: - [ ] Proxmox server hostname or IP - [ ] Proxmox API token (see API Token Setup) - [ ] UV installed (pip install uv)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
create_vm
list_snapshots
create_snapshot
delete_snapshot
rollback_snapshot
get_containers
create_container
delete_container
list_backups
create_backup
restore_backup
delete_backup
list_isos
list_templates
download_iso
delete_iso
get_nodes
get_node_status
get_vms
get_storage
get_cluster_status
execute_vm_command

How to install the Proxmoxmcp Plus MCP Server

{
  "mcpServers": {
    "ProxmoxMCP-Plus": {
      "command": "/absolute/path/to/ProxmoxMCP-Plus/.venv/bin/python",
      "args": [
        "-m",
        "proxmox_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "/absolute/path/to/ProxmoxMCP-Plus/src",
        "PROXMOX_MCP_CONFIG": "/absolute/path/to/ProxmoxMCP-Plus/proxmox-config/config.json",
        "PROXMOX_HOST": "your-proxmox-host",
        "PROXMOX_USER": "username@pve",
        "PROXMOX_TOKEN_NAME": "YOUR_PROXMOX_TOKEN_NAME",
        "PROXMOX_TOKEN_VALUE": "YOUR_PROXMOX_TOKEN_VALUE",
        "PROXMOX_PORT": "8006",
        "PROXMOX_VERIFY_SSL": "false",
        "PROXMOX_SERVICE": "PVE",
        "LOG_LEVEL": "DEBUG"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • UV package manager (recommended) - Python 3.9 or higher - Git - Access to a Proxmox server with API token credentials Before starting, ensure you have: - [ ] Proxmox server hostname or IP - [ ] Proxmox API token (see API Token Setup) - [ ] UV installed (pip install uv)
VariableDescriptionRequired
PYTHONPATHDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_MCP_CONFIGDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_HOSTDeclared in the maintainer’s client configuration.Yes
PROXMOX_USERDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_TOKEN_NAMEDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_TOKEN_VALUEDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_PORTDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_VERIFY_SSLDeclared in the maintainer’s client configuration.Check documentation
PROXMOX_SERVICEDeclared in the maintainer’s client configuration.Check documentation
LOG_LEVELDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Proxmoxmcp Plus to Prerequisites.”
  • “Use Proxmoxmcp Plus to create vm.”
  • “Use Proxmoxmcp Plus to list snapshots.”

Frequently asked questions

An enhanced Python-based Model Context Protocol (MCP) server for interacting with Proxmox virtualization platforms. This project extends Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.