Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"proxmox": {
"env": {
"PROXMOX_HOST": "192.168.1.100",
"PROXMOX_TOKEN_ID": "user@pam!mcp",
"PROXMOX_TOKEN_SECRET": "your-token-secret"
},
"args": [
"mcp-proxmox"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP server for managing Proxmox VE clusters through AI assistants like Claude, Cursor, and Cline.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'mcp-proxmox' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked mcp-proxmox against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in devops / cloud
MCP server for using the GitLab API
MCP Server for GCP environment for interacting with various Observability APIs.
Yunxiao MCP Server provides AI assistants with the ability to interact with the Yunxiao platform. It provides a set of tools that interact with Yunxiao's API, allowing AI assistants to manage Codeup repository, Project, Pipeline, Packages etc.
Enhanced MCP server for GitLab: group projects listing and activity tracking
MCP Security Weekly
Get CVE alerts and security updates for Proxmox MCP Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
MCP server for managing Proxmox VE clusters through AI assistants like Claude, Cursor, and Cline.
Provision, manage, and monitor your entire Proxmox infrastructure through natural language. Create VMs and containers, manage snapshots, browse storage, and more.
# Run directly with uvx (no install needed)
uvx mcp-proxmox
# Or install with pip
pip install mcp-proxmox
Set these environment variables (or create a .env file):
PROXMOX_HOST=192.168.1.100 # Your Proxmox VE host
PROXMOX_TOKEN_ID=user@pam!mcp # API token ID
PROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # API token secret
Optional:
PROXMOX_PORT=8006 # Default: 8006
PROXMOX_VERIFY_SSL=false # Default: false
VM.Audit — read VM/CT status and configVM.PowerMgmt — start/stop/shutdown/rebootVM.Snapshot — create/rollback/delete snapshotsVM.Allocate — create/delete/clone VMs and containersVM.Clone — clone operationsDatastore.Audit — list storages and browse contentDatastore.AllocateSpace — allocate disk space for new VMs/CTsSys.Audit — read node status and tasksVM.Config.Disk — resize disksVM.Config.CPU — change CPU allocationVM.Config.Memory — change memory allocationVM.Monitor — access QEMU monitor (for metrics)VM.Migrate — migrate VMs/CTs between nodesSys.Modify — manage firewall rulesVM.Config.Cloudinit — configure cloud-init parametersAdd to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"proxmox": {
"command": "uvx",
"args": ["mcp-proxmox"],
"env": {
"PROXMOX_HOST": "192.168.1.100",
"PROXMOX_TOKEN_ID": "user@pam!mcp",
"PROXMOX_TOKEN_SECRET": "your-token-secret"
}
}
}
}
Add to .claude/settings.json or ~/.claude/settings.json:
{
"mcpServers": {
"proxmox": {
"command": "uvx",
"args": ["mcp-proxmox"],
"env": {
"PROXMOX_HOST": "192.168.1.100",
"PROXMOX_TOKEN_ID": "user@pam!mcp",
"PROXMOX_TOKEN_SECRET": "your-token-secret"
}
}
}
}
Add to Cursor Settings > MCP with the same configuration as above.
| Tool | Description |
|---|---|
list_nodes | List all cluster nodes with CPU, memory, and uptime |
get_node_status | Detailed node info: CPU model, memory, disk, versions |
list_vms | List QEMU VMs (filter by node or status) |
list_containers | List LXC containers (filter by node or status) |
get_guest_status | Detailed VM/CT status by VMID (auto-detects type and node) |
| Tool | Description |
|---|---|
start_guest | Start a stopped VM or container |
stop_guest | Force-stop (requires confirmation) |
shutdown_guest | Graceful ACPI/init shutdown |
reboot_guest | Reboot (requires confirmation) |
| Tool | Description |
|---|---|
list_storages | List storage pools with capacity and usage (filter by node) |
list_storage_content | Browse ISOs, templates, backups, and disk images |
| Tool | Description |
|---|---|
create_vm | Create a QEMU VM with configurable CPU, memory, disk, ISO, and network |
| `cr |