Which integrations are available for this server?

Provides tools to monitor and manage Proxmox VE infrastructure, including VMs, containers, storage, snapshots, backups, firewall rules, cloning, migration, and cloud-init configuration.

How do I use Proxmox MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Proxmox MCP Server list all running VMs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Proxmox MCP Server

by olivier-mj

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Proxmox MCP Server

Docker Image CI

MCP Badge

Manage your Proxmox VE infrastructure using AI. Pilotez votre infrastructure Proxmox VE grâce à l'IA.

This MCP (Model Context Protocol) server allows LLMs (like Claude, Gemini, etc.) to securely monitor and control your Proxmox nodes, VMs, and containers.

🌟 Features

📊 Monitoring: View nodes (CPU/RAM), VMs, containers (LXC), storage status, and internal IPs (via Agent).
⚡ Management: Start, stop (graceful/forced), reboot, and Clone (Provisioning) machines.
🏗️ Orchestration: Migrate machines (live or offline) between nodes in a cluster.
📈 Analytics: View Historical Performance (CPU/RAM RRD data) for diagnostics.
📚 Library: Manage LXC Templates and ISOs (Download/List).
🏷️ Organization: Manage machine Tags.
🛠️ DevOps: Configure Cloud-Init (User/SSH/IP), Resize resources (CPU/RAM Hotplug), and Download ISOs.
🛡️ Security: Audit and manage Firewall rules per VM/Container.
🛡️ Protection: Manage Snapshots and Backups directly via MCP.
🎨 LobeChat Ready: Compatible with LobeChat Plugins via a dedicated REST API.
🔗 Access: Generate direct links to the NoVNC Console.
🔒 Secure: Uses Proxmox API Tokens. Machine deletion is disabled for safety.
🐳 Docker-ready: Works instantly with docker run.

Related MCP server: Proxmox MCP Server

🛠️ Tool Reference

📊 Monitoring & Diagnostics

Tool	Description
`list_infrastructure`	Shows node status (CPU, RAM, Online/Offline).
`list_machines`	Lists VMs and Containers (Filters: name, status, type).
`get_machine_config`	Shows detailed config (Cores, Memory, Disks).
`list_storage`	Shows usage & capabilities (Filter: `content_filter`).
`get_vm_agent_network`	Retrieves internal IPs via QEMU Agent.
`get_cluster_logs`	Shows global cluster error logs.
`get_machine_performance_history`	Retrieves RRD history (CPU/RAM trends).

⚡ Control & Actions

Tool	Description
`start_machine`	Starts a VM or Container.
`stop_machine`	Stops (Graceful Shutdown or Forced Stop) a machine.
`reboot_machine`	Reboots a machine.
`get_console_url`	Generates a direct link to the NoVNC console.
`resize_resources`	Adjusts CPU or RAM (Hotplug if supported).
`unlock_machine`	Unlocks a machine (removes lock file).
`set_machine_tags`	Sets tags (e.g., "prod,db").

🏗️ Provisioning & DevOps

Tool	Description
`clone_machine`	Clones a machine (Template) to a new ID.
`set_cloudinit_config`	Configures User, Password, SSH, IP via Cloud-Init.
`list_isos`	Lists available ISO files.
`download_iso`	Downloads an ISO from a URL.
`list_available_lxc_templates`	Lists system templates (Alpine, Ubuntu...).
`download_lxc_template`	Downloads an LXC template.

🛡️ Security & Protection

Tool	Description
`list_snapshots`	Lists restore points.
`create_snapshot`	Creates an instant snapshot.
`rollback_snapshot`	Restores a snapshot.
`delete_snapshot`	Deletes a snapshot to free space.
`list_backups`	Lists full backups (vzdump).
`create_backup`	Starts a full backup.
`list_firewall_rules`	Lists firewall rules.
`add_firewall_rule`	Adds a rule (ACCEPT/DROP) to the firewall.

🏗️ Orchestration (Cluster)

Tool	Description
`migrate_machine`	Moves a machine to another node (Live/Offline).

📚 Documentation

Please select your language / Veuillez choisir votre langue :

🔑 Proxmox API Token

To use this server, you need a Proxmox API Token. Pour utiliser ce serveur, vous avez besoin d'un Token API Proxmox.

Datacenter > Permissions > API Tokens > Add.
Select user, set ID (e.g., mcp), and uncheck "Privilege Separation".
Copy the Token ID and Secret.

⚙️ Environment Variables

Variable	Description	Example
`PROXMOX_URL`	URL of your Proxmox server	`https://192.168.1.10:8006`
`PROXMOX_USER`	User (usually root@pam)	`root@pam`
`PROXMOX_TOKEN_ID`	API Token Name (just the name)	`mcp_token`
`PROXMOX_TOKEN_SECRET`	API Token Secret	`xxxxxxxx-xxxx-xxxx...`
`PROXMOX_VERIFY_SSL`	Verify SSL Certificate	`false` (for self-signed)

🚀 Quick Start (Docker)

Clone this repo.
Copy .env.example to .env and fill in your Proxmox credentials.
Run:
```
docker-compose up -d --build
```
Configure your MCP client (Claude Desktop, Cursor, Gemini-CLI) to use the Docker container.

(See detailed instructions in the links above)

📦 Project Structure

mcp_proxmox/
├── docs/               # Documentation (FR/EN)
├── src/                # Python Source Code
├── .env.example        # Configuration Template
├── Dockerfile          # Docker Configuration
└── docker-compose.yml  # Docker Compose Configuration

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

VeriTeknik AOAuth
com.veriteknik
Manage VeriTeknik servers, DNS, backups and support tickets from your AI assistant.
Networking & Infrastructure Cloud Platforms Customer Support
461
VozoraOAuth
io.vozora
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
1
Rackspace SpotOAuth
io.github.rackspace-spot
Manage Rackspace Spot Kubernetes Cloudspaces, node pools, and VMs from your AI assistant.
Cloud Platforms Virtualization
2
Xitoring
io.github.xitoring
Connect AI assistants to Xitoring monitoring: servers, uptime, incidents, metrics, SSL, and alerts.
Monitoring Observability
21

Related MCP Servers

ProxmoxEmCP
Virtualization Observability
PureGrain
A
license
Not graded
quality
D
maintenance
Enables AI assistants to manage Proxmox VE infrastructure, including VMs, containers, storage, and cluster operations via natural language.
Updated 5 months ago (2026-04-27 15:45 UTC)
MIT
Proxmox MCP Server
Virtualization Cloud Platforms Networking & Infrastructure
jskoetsier
A
license
C
quality
D
maintenance
Enables management of Proxmox VE environments, including VMs, containers, storage, and cluster operations through natural language.
Updated 8 months ago (2026-02-13 07:43 UTC)
76
43 npm
MIT
pve-mcp-server
Virtualization Monitoring Observability
bubua12
A
license
Not graded
quality
D
maintenance
Enables AI assistants to monitor and analyze Proxmox VE virtualization environments via the MCP protocol.
Updated 3 months ago (2026-06-23 11:53 UTC)
MIT
proxmox-mcps
Virtualization Cloud Platforms Networking & Infrastructure
ngocdd
A
license
B
quality
D
maintenance
Enables AI assistants to manage Proxmox VE infrastructure, including VMs, containers, storage, network, high availability, replication, SDN, and node administration.
Updated 3 months ago (2026-07-11 10:47 UTC)
100
15 npm
MIT

Proxmox MCP Server

🌟 Features

🛠️ Tool Reference

📊 Monitoring & Diagnostics

⚡ Control & Actions

🏗️ Provisioning & DevOps

🛡️ Security & Protection

🏗️ Orchestration (Cluster)

📚 Documentation

🔑 Proxmox API Token

⚙️ Environment Variables

🚀 Quick Start (Docker)

📦 Project Structure

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

ProxmoxEmCP

Proxmox MCP Server

pve-mcp-server

proxmox-mcps