Control Proxmox VE virtual machines, LXC containers, backups and snapshots from LLMs and agents via MCP or OpenAPI.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add proxmoxmcp-plus --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_USER='<PROXMOX_USER>' --env PROXMOX_TOKEN_NAME='<PROXMOX_TOKEN_NAME>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plus~/.codex/config.toml
[mcp_servers.proxmoxmcp-plus]
command = "uvx"
args = ["proxmox-mcp-plus"]
env = { PROXMOX_HOST = "<PROXMOX_HOST>", PROXMOX_USER = "<PROXMOX_USER>", PROXMOX_TOKEN_NAME = "<PROXMOX_TOKEN_NAME>", PROXMOX_TOKEN_VALUE = "<PROXMOX_TOKEN_VALUE>" }
# codex mcp add proxmoxmcp-plus --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_USER='<PROXMOX_USER>' --env PROXMOX_TOKEN_NAME='<PROXMOX_TOKEN_NAME>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plus~/.cursor/mcp.json
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"proxmoxmcp-plus": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Environment variables
PROXMOX_HOSTPROXMOX_USERPROXMOX_TOKEN_NAMEPROXMOX_TOKEN_VALUE
Replace the placeholders with your own credentials and keep them out of version control.