What can you do with this server?

This server provides 38 tools for managing a Proxmox VE cluster across nodes, QEMU VMs, LXC containers, storage, and cluster resources. Operations are gated by the PROXMOX_RISK_LEVEL environment variable: read (default, read-only), lifecycle (start/stop/clone/snapshot), all (destructive: delete/rollback). Node Management * List nodes with status, CPU, memory, uptime; get detailed metrics (disk, load, kernel) * View network interfaces and physical disks * List recent tasks; get task status or log output by UPID QEMU VM Management * List, get status/config/snapshots of VMs * Start, stop (force), shutdown, reboot, suspend, resume, clone (lifecycle) * Create snapshots (lifecycle); delete or rollback snapshots (all) LXC Container Management * List, get status/config/snapshots of containers * Start, stop (force), shutdown, reboot (lifecycle) * Create snapshots (lifecycle); delete or rollback snapshots (all) Storage Management * List storage pools with usage info * Browse contents filtered by type (ISOs, disk images, backups, templates) Cluster Management * Get cluster health, quorum state, and node membership * List all resources (VMs, containers, storage, nodes) with optional type filtering * View configured backup jobs (vzdump schedules) * Get the next available VM/container ID

Which integrations are available for this server?

Provides tools for managing Proxmox VE environments, including nodes, QEMU VMs, LXC containers, storage, cluster resources, and backups with configurable risk levels for destructive operations. Allows management of QEMU virtual machines, including start, stop, shutdown, reboot, suspend, resume, clone, and snapshot operations.

de en es ja ko ru zh

proxmox-mcp

by akmalovaa

Overview Schema Related Servers Score Discussions

Python

Remote

Proxmox MCP server

Release License: MIT Python 3.14 GHCR MCP

Simple Proxmox MCP

MCP server for managing Proxmox VE

38 tools — nodes, QEMU VMs, LXC containers, storage, cluster, snapshots.

Why this one?

One image, multi-arch — docker run ghcr.io/akmalovaa/proxmox-mcp:latest and you're done
Just env vars — no config files, no database, no state
Read-only by default — destructive ops are gated behind an explicit PROXMOX_RISK_LEVEL
Tiny codebase — pure stdio MCP over Proxmoxer, no HTTP server, no auth layer, no extras
Raw JSON out — no formatting, no emoji; LLM gets clean data

proxmox-mcp MCP server

Related MCP server: nandi-proxmox-mcp

Quick start

Image: ghcr.io/akmalovaa/proxmox-mcp:latest (multi-arch: amd64 + arm64).

1. Export credentials in your shell profile (~/.zprofile, ~/.zshrc or ~/.bashrc):

# base environment:
export PROXMOX_HOST=192.168.1.100
export PROXMOX_USER=root@pam
export PROXMOX_PASSWORD=your-password

# or use token auth (recommended):
export PROXMOX_TOKEN_NAME=mcp
export PROXMOX_TOKEN_VALUE=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

# optional:
export PROXMOX_RISK_LEVEL=read

Reload: source ~/.zprofile (or restart the shell).

2. Add to ~/.claude/settings.json (Claude Code) or claude_desktop_config.json (Claude Desktop):

{
  "mcpServers": {
    "proxmox": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "PROXMOX_HOST",
        "-e", "PROXMOX_USER",
        "-e", "PROXMOX_PASSWORD",
        "ghcr.io/akmalovaa/proxmox-mcp:latest"]
    }
  }
}

or token auth:

{
  "mcpServers": {
    "proxmox": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "PROXMOX_HOST",
        "-e", "PROXMOX_USER",
        "-e", "PROXMOX_TOKEN_NAME",
        "-e", "PROXMOX_TOKEN_VALUE",
        "ghcr.io/akmalovaa/proxmox-mcp:latest"]
    }
  }
}

docker run -e VAR without a value passes the host variable through — no secrets in the config file. Restart the client — 38 Proxmox tools become available.

For password auth, swap the token vars for PROXMOX_PASSWORD.

Note: Claude Desktop on macOS is launched via launchd and does not inherit ~/.zprofile/~/.zshrc. Either put the exports in ~/.zshenv, or fall back to an inline "env": { ... } block in the config.

Configuration

All settings are environment variables — set them in your shell profile, pass them inline to docker run -e, or declare them in your MCP client's env block.

Variable	Default	Description
`PROXMOX_HOST`	—	Proxmox host (IP or hostname)
`PROXMOX_USER`	`root@pam`	API user
Auth	—	token or password — see below
`PROXMOX_PORT`	`8006`	API port
`PROXMOX_VERIFY_SSL`	`false`	Verify TLS certificate
`PROXMOX_RISK_LEVEL`	`read`	`read` / `lifecycle` / `all`

Authentication: token or password

Pick one. If both are set, the token wins.

Token (recommended) — create in Proxmox UI: Datacenter → Permissions → API Tokens → Add (uncheck Privilege Separation). Then:

export PROXMOX_TOKEN_NAME=mcp
export PROXMOX_TOKEN_VALUE=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Password (fallback):

export PROXMOX_PASSWORD=your-password

Risk levels

PROXMOX_RISK_LEVEL controls which tools exist. Tools above the active level are not registered, so they never appear in the MCP client's tool list:

Level	Tools	Adds
`read` (default)	21	read-only tools
`lifecycle`	34	+ start / stop / reboot / suspend / clone / create-snapshot
`all`	38	+ delete-snapshot / rollback-snapshot

Each elevated call is also re-checked at call time and logged to stderr (ALLOW / DENY + tool + tier).

Tools

Nodes (7)

Tool	Description
`list_nodes`	List all cluster nodes with status, CPU, memory, uptime
`get_node_status`	Detailed node metrics (CPU, memory, disk, load, kernel)
`get_node_networks`	Network interfaces on a node
`get_node_disks`	Physical disks on a node
`get_node_tasks`	Recent tasks on a node
`get_task_status`	Status of a specific task by UPID
`get_task_log`	Log output from a task

QEMU VMs (14)

Tool	Tier	Description
`list_vms`	read	List all VMs, optionally filter by node
`get_vm_status`	read	Current VM status (running/stopped, CPU, memory)
`get_vm_config`	read	VM configuration (hardware, disks, network)
`list_vm_snapshots`	read	List all snapshots of a VM
`start_vm`	lifecycle	Start a VM
`stop_vm`	lifecycle	Force-stop a VM
`shutdown_vm`	lifecycle	Graceful ACPI shutdown with timeout
`reboot_vm`	lifecycle	Reboot via ACPI
`suspend_vm`	lifecycle	Suspend a VM
`resume_vm`	lifecycle	Resume a suspended VM
`clone_vm`	lifecycle	Full or linked clone
`create_vm_snapshot`	lifecycle	Create a snapshot
`delete_vm_snapshot`	all	Delete a snapshot
`rollback_vm_snapshot`	all	Rollback to a snapshot

LXC Containers (11)

Tool	Tier	Description
`list_containers`	read	List all LXC containers, optionally filter by node
`get_container_status`	read	Current container status
`get_container_config`	read	Container configuration
`list_container_snapshots`	read	List all snapshots
`start_container`	lifecycle	Start a container
`stop_container`	lifecycle	Force-stop a container
`shutdown_container`	lifecycle	Graceful shutdown with timeout
`reboot_container`	lifecycle	Reboot a container
`create_container_snapshot`	lifecycle	Create a snapshot
`delete_container_snapshot`	all	Delete a snapshot
`rollback_container_snapshot`	all	Rollback to a snapshot

Storage (2)

Tool	Description
`list_storage`	Storage pools with usage, optionally filter by node
`get_storage_content`	Contents of a storage pool (ISOs, backups, images, templates)

Cluster (4)

Tool	Description
`get_cluster_status`	Cluster health, quorum, node membership
`get_cluster_resources`	All resources (VMs, containers, storage, nodes)
`get_cluster_backups`	Configured backup jobs
`get_next_vmid`	Next available VM/container ID

Architecture

src/proxmox_mcp/
├── server.py    # FastMCP instance + entry point
├── config.py    # Pydantic Settings (PROXMOX_ prefix)
├── client.py    # Proxmoxer connection via lifespan
└── tools/       # nodes, vms, containers, storage, cluster

Read-only by default — elevated tools gated by PROXMOX_RISK_LEVEL
Single connection — Proxmoxer client created once at startup, shared via lifespan
Raw JSON output — no formatting; LLM consumes data directly

Development

Run standalone (testing)

export PROXMOX_HOST=192.168.1.100
export PROXMOX_USER=root@pam
export PROXMOX_TOKEN_NAME=mcp
export PROXMOX_TOKEN_VALUE=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

docker run -i --rm \
  -e PROXMOX_HOST -e PROXMOX_USER \
  -e PROXMOX_TOKEN_NAME -e PROXMOX_TOKEN_VALUE \
  ghcr.io/akmalovaa/proxmox-mcp:latest

Without Docker (UV)

git clone https://github.com/akmalovaa/proxmox-mcp.git && cd proxmox-mcp && uv sync

MCP client config:

{
  "mcpServers": {
    "proxmox": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/proxmox-mcp", "python", "-m", "proxmox_mcp"],
      "env": {
        "PROXMOX_HOST": "192.168.1.100",
        "PROXMOX_TOKEN_NAME": "mcp",
        "PROXMOX_TOKEN_VALUE": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

Build from source

git clone https://github.com/akmalovaa/proxmox-mcp.git
cd proxmox-mcp
docker build -t proxmox-mcp .

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

6Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

kubernetes-mcp-server
Cloud Platforms Developer Tools Virtualization
containers
A
license
-
quality
A
maintenance
A powerful and flexible Kubernetes MCP server implementation with support for OpenShift.
Updated 2 days ago (2026-08-12 21:47 UTC)
1,947
Go
Apache 2.0
nandi-proxmox-mcp
Virtualization Cloud Platforms Monitoring
NANDI-Services
A
license
-
quality
C
maintenance
An open-source MCP server for managing Proxmox environments, including nodes, virtual machines, and containers. It enables users to perform inventory checks, status monitoring, and control operations directly through MCP-compatible tools.
Updated 4 months ago (2026-04-14 21:09 UTC)
122
MIT
Proxmox MCP Server
Virtualization Cloud Platforms
Bldg-7
A
license
B
quality
C
maintenance
A comprehensive MCP server providing 92 tools for managing Proxmox Virtual Environment, including QEMU VMs and LXC containers.
Updated a month ago (2026-07-14 06:40 UTC)
92
92
5
MIT
Proxmox MCP Server
Virtualization Networking & Infrastructure
fredriksknese
F
license
B
quality
C
maintenance
Comprehensive MCP server for Proxmox VE with 68 tools and 4 resources covering VMs, containers, storage, networking, clusters, HA, backups, firewall, and access control.
Updated 3 months ago (2026-05-29 03:29 UTC)
68

View all related MCP servers

Related MCP Connectors

neverinfamous-memory-journal-mcp
A MCP server built for developers enabling Git based project management with project and personal…
GitLab MCP Server
Go MCP server for GitLab: 2 dynamic tools reach 1000+ REST/GraphQL actions. Free/CE, no paid tier.
better-notion-mcp
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/akmalovaa/proxmox-mcp'

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

Proxmox MCP server

Simple Proxmox MCP

Why this one?

Quick start

Configuration

Authentication: token or password

Risk levels

Tools

Nodes (7)

QEMU VMs (14)

LXC Containers (11)

Storage (2)

Cluster (4)

Architecture

Development

Run standalone (testing)

Without Docker (UV)

Build from source

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

kubernetes-mcp-server

nandi-proxmox-mcp

Proxmox MCP Server

Proxmox MCP Server

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API