Skip to main content
Glama
Ruashots

Proxmox MCP Server

by Ruashots

Proxmox MCP Server

MCP (Model Context Protocol) server for the Proxmox VE API. Manage VMs and containers through Claude Code.

Features

55 essential tools for day-to-day Proxmox management:

  • Nodes: List nodes, get status and version

  • QEMU VMs: List, status, start/stop/reboot, snapshots, clone, migrate

  • LXC Containers: List, status, start/stop/reboot, snapshots, clone, migrate

  • Storage: List storage, browse content, check status

  • Tasks: View running tasks and logs

Quick Install

curl -fsSL https://raw.githubusercontent.com/Ruashots/proxmox-mcp/master/install.sh | bash

Prerequisites

  • Node.js 18+

  • jq (sudo apt install jq)

  • Proxmox VE 7.0+ with API token

Manual Installation

git clone https://github.com/Ruashots/proxmox-mcp.git ~/.local/share/proxmox-mcp cd ~/.local/share/proxmox-mcp npm install && npm run build

Add to ~/.claude.json:

{ "mcpServers": { "proxmox-mcp": { "command": "node", "args": ["/home/YOUR_USER/.local/share/proxmox-mcp/dist/index.js"], "env": { "PROXMOX_HOST": "https://192.168.1.100:8006", "PROXMOX_TOKEN_ID": "root@pam!claude", "PROXMOX_TOKEN_SECRET": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } } } }

Tools

Nodes

Tool

Description

pve_list_nodes

List all nodes

pve_get_nodes_status

Get node status

pve_get_nodes_version

Get node version

QEMU VMs

Tool

Description

pve_list_nodes_qemu

List all VMs on a node

pve_get_nodes_qemu

Get VM details

pve_get_nodes_qemu_config

Get VM configuration

pve_update_nodes_qemu_config

Update VM configuration

pve_get_nodes_qemu_status_current

Get current VM status

pve_create_nodes_qemu_status_start

Start VM

pve_create_nodes_qemu_status_stop

Stop VM (hard)

pve_create_nodes_qemu_status_shutdown

Shutdown VM (graceful)

pve_create_nodes_qemu_status_reboot

Reboot VM

pve_create_nodes_qemu_status_suspend

Suspend VM

pve_create_nodes_qemu_status_resume

Resume VM

pve_list_nodes_qemu_snapshot

List snapshots

pve_create_nodes_qemu_snapshot

Create snapshot

pve_get_nodes_qemu_snapshot

Get snapshot details

pve_delete_nodes_qemu_snapshot

Delete snapshot

pve_create_nodes_qemu_snapshot_rollback

Rollback to snapshot

pve_create_nodes_qemu_clone

Clone VM

pve_create_nodes_qemu_migrate

Migrate VM to another node

LXC Containers

Tool

Description

pve_list_nodes_lxc

List all containers on a node

pve_get_nodes_lxc

Get container details

pve_get_nodes_lxc_config

Get container configuration

pve_update_nodes_lxc_config

Update container configuration

pve_get_nodes_lxc_status_current

Get current container status

pve_create_nodes_lxc_status_start

Start container

pve_create_nodes_lxc_status_stop

Stop container

pve_create_nodes_lxc_status_shutdown

Shutdown container

pve_create_nodes_lxc_status_reboot

Reboot container

pve_create_nodes_lxc_status_suspend

Suspend container

pve_create_nodes_lxc_status_resume

Resume container

pve_list_nodes_lxc_snapshot

List snapshots

pve_create_nodes_lxc_snapshot

Create snapshot

pve_get_nodes_lxc_snapshot

Get snapshot details

pve_delete_nodes_lxc_snapshot

Delete snapshot

pve_create_nodes_lxc_snapshot_rollback

Rollback to snapshot

pve_create_nodes_lxc_clone

Clone container

pve_create_nodes_lxc_migrate

Migrate container

Storage

Tool

Description

pve_list_nodes_storage

List storage on a node

pve_get_nodes_storage_status

Get storage status

pve_list_nodes_storage_content

List storage content

Tasks

Tool

Description

pve_list_nodes_tasks

List tasks

pve_get_nodes_tasks_status

Get task status

pve_get_nodes_tasks_log

Get task log

Example Usage

  • "List all VMs on node pve"

  • "Start VM 100 on node pve"

  • "Create a snapshot of container 101 called before-update"

  • "Show storage status on node pve"

  • "What tasks are running on node pve?"

Creating an API Token

  1. Proxmox UI → Datacenter → Permissions → API Tokens → Add

  2. Select user (e.g., root@pam), enter Token ID (e.g., claude)

  3. Uncheck "Privilege Separation" for full access

  4. Copy the secret immediately!

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ruashots/proxmox-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server