What are the prerequisites for installing Proxmox Manager?

You need Python 3.10+, Git, UV package manager (recommended), and access to a Proxmox server with API token credentials. You'll also need the Proxmox server's hostname/IP and API token information.

Can I use Proxmox Manager with Cline?

Yes! Proxmox Manager has full integration with Cline. The documentation provides detailed configuration instructions to seamlessly integrate Proxmox management within your Cline environment, including absolute paths and environment variable setups.

What credentials does it need?

It reads `PYTHONPATH`, `PROXMOX_MCP_CONFIG`, `PROXMOX_HOST`, `PROXMOX_USER`, `PROXMOX_TOKEN_NAME`, `PROXMOX_TOKEN_VALUE`, `PROXMOX_PORT`, `PROXMOX_VERIFY_SSL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Proxmox Manager MCP Server

Manage Proxmox hypervisors through a Model Context Protocol server, providing a clean interface for nodes, VMs, and containers.

Local serverstdioPython★ 284

What is the Proxmox Manager MCP Server?

Manage Proxmox hypervisors through a Model Context Protocol server, providing a clean interface for nodes, VMs, and containers.

Configuration

UV package manager (recommended) - Python 3.10 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.

Tool	What it does
get_nodes	🖥️ pve-compute-01 • Status: ONLINE • Uptime: ⏳ 156d 12h • CPU Cores: 64 • Memory: 186.5 GB / 512.0 GB (36.4%)
get_node_status
get_vms	🗃️ prod-db-master (ID: 100) • Status: RUNNING • Node: pve-compute-01 • CPU Cores: 16 • Memory: 92.3 GB / 128.0 GB (72.1%)
get_storage
get_cluster_status	• Name: enterprise-cloud • Status: HEALTHY • Quorum: OK • Nodes: 4 ONLINE • Version: 8.1.3 • HA Status: ACTIVE • Resources: - Total CPU Cores: 192 - Total Memory: 1536 GB - Total Storage: 70 TB • Workload: - Running VMs:
execute_vm_command	Output: ● nginx.service - A high performance web server and a reverse proxy server Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled) Active: active (running) since Tue 2025-02-18 15:23:4

Configuration

UV package manager (recommended) - Python 3.10 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)

Variable	Description	Required
PYTHONPATH	Python module search path for a local installation.	Optional
PROXMOX_MCP_CONFIG	Configuration value read at startup.	Optional
PROXMOX_HOST	Endpoint or connection string the server talks to.	Optional
PROXMOX_USER	Configuration value read at startup.	Optional
PROXMOX_TOKEN_NAME	Credential the server authenticates with.	Yes
PROXMOX_TOKEN_VALUE	Credential the server authenticates with.	Yes
PROXMOX_PORT	Configuration value read at startup.	Optional
PROXMOX_VERIFY_SSL	Configuration value read at startup.	Optional

Example prompts to try

“Use Proxmox Manager to Prerequisites.”
“Use Proxmox Manager to get nodes.”
“Use Proxmox Manager to get node status.”

Frequently asked questions

Proxmox Manager is a Python-based Model Context Protocol (MCP) server that provides a clean interface for managing Proxmox hypervisors, nodes, VMs, and containers. It simplifies Proxmox administration.