Mcp Proxmox

Name: Mcp Proxmox
Author: antonio-mello-ai

by antonio-mello-aicommunityv1.2.1

MCP server for managing Proxmox VE clusters through AI assistants. It can provision, monitor, and administer VMs, LXC containers, storage, snapshots, backups, firewall rules, migrations, and cloud-init settings via natural language and exposed tools.

From the registry: Manage Proxmox VE clusters through AI assistants — VMs, containers, and more

GitHub Repository

Install & configure

Prerequisites

required
Proxmox API token
Create API token in Proxmox UI: Datacenter > Permissions > API Tokens

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `mcp-proxmox` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Proxmox API token** — Create API token in Proxmox UI: Datacenter > Permissions > API Tokens

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["mcp-proxmox"]
- required environment variables:
  - `PROXMOX_HOST`: Your Proxmox VE host (example: `192.168.1.100`)
  - `PROXMOX_TOKEN_ID`: API token ID (example: `user@pam!mcp`)
  - `PROXMOX_TOKEN_SECRET`: API token secret (example: `<your-token-secret>`)
- optional environment variables:
  - `PROXMOX_PORT`: Proxmox port (example: `8006`)
  - `PROXMOX_VERIFY_SSL`: Verify SSL certificates (example: `false`)

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Tools (34)

list_nodes

List all cluster nodes with CPU, memory, and uptime

get_node_status

Detailed node info including CPU model, memory, disk, and versions

list_vms

List QEMU VMs, optionally filtered by node or status

list_containers

List LXC containers, optionally filtered by node or status

get_guest_status

Get detailed VM/CT status by VMID with auto-detection of type and node

start_guest

Start a stopped VM or container

stop_guest

Force-stop a VM or container

shutdown_guest

Gracefully shut down a VM or container

reboot_guest

Reboot a VM or container

list_storages

List storage pools with capacity and usage

list_storage_content

Browse ISOs, templates, backups, and disk images

create_vm

Create a QEMU VM with configurable CPU, memory, disk, ISO, and network

create_container

Create an LXC container from a template

clone_guest

Environment variables

PROXMOX_HOSTrequiredProxmox VE host address

PROXMOX_TOKEN_IDrequiredProxmox API token ID

PROXMOX_TOKEN_SECRETrequiredProxmox API token secret

Packages

mcp-proxmox

pypiv1.2.1transport: stdio

Details

Language: Python
License: MIT
Released: Mar 10, 2026
Last commit: Mar 10, 2026
Registry name: io.github.antonio-mello-ai/mcp-proxmox

Related Servers

Mcp

Real-time Kubernetes network traffic visibility and API analysis for HTTP, gRPC, Redis, Kafka, DNS.

11.9k

Firebase Mcp

Gives AI development tools Firebase-specific capabilities and expertise.

4.4k

Azure MCP Server

All Azure MCP tools to create a seamless connection between AI agents and Azure services.

3.2k

Clone a VM or container, including full/linked and cross-node support

delete_guest

Permanently delete a stopped VM or container

list_backups

List backup files filtered by node, storage, or VMID

create_backup

Create a vzdump backup in snapshot, suspend, or stop mode

restore_backup

Restore a VM or container from a backup file

exec_command

Run a command inside a QEMU VM via guest agent

list_snapshots

List all snapshots for a VM or container

create_snapshot

Create a new snapshot

rollback_snapshot

Rollback to a snapshot

delete_snapshot

Delete a snapshot

list_networks

List bridges, bonds, and physical interfaces on a node

resize_guest

Resize CPU, memory, and/or disk of a VM or container

get_guest_metrics

Get CPU, memory, network, and disk I/O metrics over time

list_tasks

List recent tasks on a node

list_firewall_rules

List firewall rules for a VM/CT, node, or cluster

add_firewall_rule

Add a firewall rule with action, direction, protocol, port, and source/destination

delete_firewall_rule

Delete a firewall rule by position

migrate_guest

Live or offline migrate a VM or container to another node

list_templates

List all VM templates available for cloning

create_template

Convert a stopped VM into a template

configure_cloud_init

Set user, password, SSH keys, IP config, and DNS on a VM

Microsoft Fabric MCP Server

MCP tools for interacting with Microsoft Fabric