How do I install Proxmox MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Proxmox MCP need an API key?

The publisher lists these environment variables: PROXMOX_HOST, PROXMOX_API_TOKEN, PROXMOX_TLS_FINGERPRINT, PROXMOX_PBS_HOST, PROXMOX_PBS_API_TOKEN, PROXMOX_PBS_TLS_FINGERPRINT, PROXMOX_BASE_URL, PROXMOX_CLUSTER, PROXMOX_CLUSTERS_FILE, PROXMOX_USER_AGENT, PROXMOX_MCP_READ_ONLY, PROXMOX_MCP_HTTP_TOKEN, PRINTING_PRESS_CLIENT_PROFILE, PROXMOX_NO_LOCAL_DATA.

What transport does Proxmox MCP use?

Proxmox MCP runs locally over stdio.

When was Proxmox MCP last checked?

Last checked 2026-11-10. Read-only Proxmox VE and Backup Server: which client guests have a verified, recent restore point.

Proxmox MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

mcpb https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.3/proxmox-mcp.mcpb

Credentials from the publisher

PROXMOX_HOST — Proxmox VE host name or IP (API on port 8006).
PROXMOX_API_TOKEN — Proxmox VE API token USER@REALM!TOKENID=SECRET; PVEAuditor, plus Datastore.AllocateSpace and VM.Backup if backups live on PVE storage.
PROXMOX_TLS_FINGERPRINT — SHA-256 fingerprint of the PVE certificate to pin (stock Proxmox certificates are self-signed).
PROXMOX_PBS_HOST — Optional Proxmox Backup Server host, host:port, or https://host:port (default port 8007).
PROXMOX_PBS_API_TOKEN — Optional Proxmox Backup Server API token USER@REALM!TOKENID:SECRET (colon before the secret).
PROXMOX_PBS_TLS_FINGERPRINT — Optional SHA-256 fingerprint of the PBS certificate to pin.
PROXMOX_BASE_URL — Full PVE API base such as https://pve1:8006/api2/json; overrides PROXMOX_HOST. Leave blank to use PROXMOX_HOST.
PROXMOX_CLUSTER — Name of the clusters.toml entry to use by default (same as --cluster). Leave blank to run across every configured cluster.
PROXMOX_CLUSTERS_FILE — Path to the clusters.toml that lists client clusters. Leave blank for the default. Each cluster's token variables must also be in the server's environment.
PROXMOX_USER_AGENT — Overrides the User-Agent the CLI sends on Proxmox requests. Leave blank to use the CLI's own.
PROXMOX_MCP_READ_ONLY — Set to 1 to drop the sync, export, workflow archive and learnings forget/reject MCP tools. The learning-store tools (teach, playbook) still write locally. Proxmox itself is never written either way. Leave blank for the full tool set.
PROXMOX_MCP_HTTP_TOKEN — Required only when running the MCP server with --transport http (a remote or hosted deployment); the server refuses to start without it. Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses.
PRINTING_PRESS_CLIENT_PROFILE — Leave blank. This connector registers no tenant-gated profile source, so the value is read but changes nothing; select client clusters with PROXMOX_CLUSTER or clusters.toml instead.
PROXMOX_NO_LOCAL_DATA — Optional. Set to 1 to keep no local copy of API responses: reads go to the API, store writes are off, and sync and workflow archive refuse to run. Leave blank to keep the local store.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1PROXMOX_HOST=<value> PROXMOX_API_TOKEN=<secret> PROXMOX_TLS_FINGERPRINT=<value> PROXMOX_PBS_HOST=<value> PROXMOX_PBS_API_TOKEN=<secret> PROXMOX_PBS_TLS_FINGERPRINT=<value> PROXMOX_BASE_URL=<value> PROXMOX_CLUSTER=<value> PROXMOX_CLUSTERS_FILE=<value> PROXMOX_USER_AGENT=<value> PROXMOX_MCP_READ_ONLY=<value> PROXMOX_MCP_HTTP_TOKEN=<secret> PRINTING_PRESS_CLIENT_PROFILE=<secret> PROXMOX_NO_LOCAL_DATA=<value> claude mcp add io.github.servosity-proxmox-mcp -- mcpb https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.3/proxmox-mcp.mcpb

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.servosity-proxmox-mcp": {4      "command": "mcpb",5      "args": [6        "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.3/proxmox-mcp.mcpb"7      ],8      "env": {9        "PROXMOX_HOST": "<value>",10        "PROXMOX_API_TOKEN": "<secret>",11        "PROXMOX_TLS_FINGERPRINT": "<value>",12        "PROXMOX_PBS_HOST": "<value>",13        "PROXMOX_PBS_API_TOKEN": "<secret>",14        "PROXMOX_PBS_TLS_FINGERPRINT": "<value>",15        "PROXMOX_BASE_URL": "<value>",16        "PROXMOX_CLUSTER": "<value>",17        "PROXMOX_CLUSTERS_FILE": "<value>",18        "PROXMOX_USER_AGENT": "<value>",19        "PROXMOX_MCP_READ_ONLY": "<value>",20        "PROXMOX_MCP_HTTP_TOKEN": "<secret>",21        "PRINTING_PRESS_CLIENT_PROFILE": "<secret>",22        "PROXMOX_NO_LOCAL_DATA": "<value>"23      }24    }25  }26}

claude_desktop_config.json

Local · mcpbPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Proxmox MCP

Add this server

Host a copy with our keys and logs.

Tools

Questions

Server facts

How do I install Proxmox MCP?

Does Proxmox MCP need an API key?

What transport does Proxmox MCP use?

When was Proxmox MCP last checked?

Documentation