AI - Gemini CLI - Proxmox MCP

Calendar April 1, 2026
Homelab
Proxmox, Mcp, Gemini-Cli

Proxmox MCP Installation (Sillicon Mac) Intel below#

This guide details the process for installing the Proxmox Model Context Protocol (MCP) server and integrating it with Gemini-CLI to manage virtual machines and containers directly from the terminal.

1 Prerequisites#

  • Proxmox VE: Access to a Proxmox cluster or node.
  • Gemini-CLI: Installed via Homebrew or npm.
  • Python 3.10+: Required for the MCP server environment.
  • API Token: Created in Proxmox (Datacenter > Permissions > API Tokens). Ensure the token has sufficient permissions (e.g., PVEAuditor or PVEVMAdmin) and ‘Privilege Separation’ is unchecked.

2 Server Installation#

Run the following commands to clone the repository and set up the Python environment in a dedicated directory.