Install guide · Claude Desktop
Install Proxmox VE for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "mattoddie-proxmox-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/mattoddie/proxmox-mcp:0.5.1" ], "env": { "MCP_TRANSPORT": "", "PROXMOX_URL": "", "PROXMOX_API_TOKEN": "YOUR_PROXMOX_API_TOKEN", "PROXMOX_USERNAME": "", "PROXMOX_PASSWORD": "YOUR_PROXMOX_PASSWORD", "PROXMOX_TLS_FINGERPRINT": "", "PROXMOX_VERIFY_SSL": "", "PROXMOX_DEFAULT_NODE": "", "PROXMOX_ALLOW_WRITES": "false", "PROXMOX_ALLOW_DELETES": "false", "PROXMOX_ALLOW_EXEC": "false", "PROXMOX_TOOLSETS": "", "PROXMOX_AUDIT_LOG": "" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |