Monitor and manage Proxmox VE clusters: VMs, containers, storage and backups. Read-only by default.
Connect Runs on your machine
claude mcp add proxmox-mcp -e MCP_TRANSPORT=<MCP_TRANSPORT> -e PROXMOX_URL=<PROXMOX_URL> -e PROXMOX_API_TOKEN=<PROXMOX_API_TOKEN> -e PROXMOX_USERNAME=<PROXMOX_USERNAME> -e PROXMOX_PASSWORD=<PROXMOX_PASSWORD> -e PROXMOX_TLS_FINGERPRINT=<PROXMOX_TLS_FINGERPRINT> -e PROXMOX_VERIFY_SSL=<PROXMOX_VERIFY_SSL> -e PROXMOX_DEFAULT_NODE=<PROXMOX_DEFAULT_NODE> -e PROXMOX_ALLOW_WRITES=<PROXMOX_ALLOW_WRITES> -e PROXMOX_ALLOW_DELETES=<PROXMOX_ALLOW_DELETES> -e PROXMOX_ALLOW_EXEC=<PROXMOX_ALLOW_EXEC> -e PROXMOX_TOOLSETS=<PROXMOX_TOOLSETS> -e PROXMOX_AUDIT_LOG=<PROXMOX_AUDIT_LOG> -- docker run -i --rm ghcr.io/mattoddie/proxmox-mcp:0.5.1
{
"mcpServers": {
"proxmox-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mattoddie/proxmox-mcp:0.5.1"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"PROXMOX_URL": "<PROXMOX_URL>",
"PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
"PROXMOX_USERNAME": "<PROXMOX_USERNAME>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"PROXMOX_TLS_FINGERPRINT": "<PROXMOX_TLS_FINGERPRINT>",
"PROXMOX_VERIFY_SSL": "<PROXMOX_VERIFY_SSL>",
"PROXMOX_DEFAULT_NODE": "<PROXMOX_DEFAULT_NODE>",
"PROXMOX_ALLOW_WRITES": "<PROXMOX_ALLOW_WRITES>",
"PROXMOX_ALLOW_DELETES": "<PROXMOX_ALLOW_DELETES>",
"PROXMOX_ALLOW_EXEC": "<PROXMOX_ALLOW_EXEC>",
"PROXMOX_TOOLSETS": "<PROXMOX_TOOLSETS>",
"PROXMOX_AUDIT_LOG": "<PROXMOX_AUDIT_LOG>"
}
}
}
}
{
"mcpServers": {
"proxmox-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mattoddie/proxmox-mcp:0.5.1"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"PROXMOX_URL": "<PROXMOX_URL>",
"PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
"PROXMOX_USERNAME": "<PROXMOX_USERNAME>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"PROXMOX_TLS_FINGERPRINT": "<PROXMOX_TLS_FINGERPRINT>",
"PROXMOX_VERIFY_SSL": "<PROXMOX_VERIFY_SSL>",
"PROXMOX_DEFAULT_NODE": "<PROXMOX_DEFAULT_NODE>",
"PROXMOX_ALLOW_WRITES": "<PROXMOX_ALLOW_WRITES>",
"PROXMOX_ALLOW_DELETES": "<PROXMOX_ALLOW_DELETES>",
"PROXMOX_ALLOW_EXEC": "<PROXMOX_ALLOW_EXEC>",
"PROXMOX_TOOLSETS": "<PROXMOX_TOOLSETS>",
"PROXMOX_AUDIT_LOG": "<PROXMOX_AUDIT_LOG>"
}
}
}
}
{
"servers": {
"proxmox-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mattoddie/proxmox-mcp:0.5.1"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"PROXMOX_URL": "<PROXMOX_URL>",
"PROXMOX_API_TOKEN": "<PROXMOX_API_TOKEN>",
"PROXMOX_USERNAME": "<PROXMOX_USERNAME>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"PROXMOX_TLS_FINGERPRINT": "<PROXMOX_TLS_FINGERPRINT>",
"PROXMOX_VERIFY_SSL": "<PROXMOX_VERIFY_SSL>",
"PROXMOX_DEFAULT_NODE": "<PROXMOX_DEFAULT_NODE>",
"PROXMOX_ALLOW_WRITES": "<PROXMOX_ALLOW_WRITES>",
"PROXMOX_ALLOW_DELETES": "<PROXMOX_ALLOW_DELETES>",
"PROXMOX_ALLOW_EXEC": "<PROXMOX_ALLOW_EXEC>",
"PROXMOX_TOOLSETS": "<PROXMOX_TOOLSETS>",
"PROXMOX_AUDIT_LOG": "<PROXMOX_AUDIT_LOG>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MCP_TRANSPORTOptional | Runs the server over stdio. The image defaults to HTTP. |
PROXMOX_URLRequired | Address of any node in the cluster, with the port. |
PROXMOX_API_TOKENOptional, secret | Recommended. The whole API token as user@realm!tokenid=secret. Leave empty to use a username and password. |
PROXMOX_USERNAMEOptional | Used instead of an API token, as user@realm (e.g. mcp@pve). |
PROXMOX_PASSWORDOptional, secret | The user's password, used with the username. |
PROXMOX_TLS_FINGERPRINTOptional | Recommended for Proxmox's self-signed certificate: its SHA-256 fingerprint. An https URL needs this or PROXMOX_VERIFY_SSL. |
PROXMOX_VERIFY_SSLOptional | Leave empty when you set a fingerprint. true: the certificate is publicly trusted. false: skip the check (insecure). |
PROXMOX_DEFAULT_NODEOptional | Node used when a request doesn't name one. Not needed on a single-node install. |
PROXMOX_ALLOW_WRITESOptional | Allow changes: start and stop guests, edit configuration, create VMs, snapshots and backups. |
PROXMOX_ALLOW_DELETESOptional | Also allow deleting guests, volumes, snapshots, backups and configuration. Needs writes. |
PROXMOX_ALLOW_EXECOptional | Also allow commands and file access inside VMs through the guest agent. Needs writes. |
PROXMOX_TOOLSETSOptional | Optional comma-separated toolsets, to expose fewer tools. Empty means all (except raw). |
PROXMOX_AUDIT_LOGOptional | Optional. stderr, or a file path inside the container, to log every change as a JSON line. |
Details
| Package | ghcr.io/mattoddie/proxmox-mcp:0.5.1 (OCI, stdio) |
| Package | https://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-darwin-arm64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-darwin-amd64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-windows-amd64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-windows-arm64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-linux-amd64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/proxmox-mcp/releases/download/v0.5.1/proxmox-mcp-0.5.1-linux-arm64.mcpb (MCPB, stdio) |
| First published | 22 Oct 2026 |
| Last updated | 22 Oct 2026 |
| Registry name | io.github.mattoddie/proxmox-mcp |
More files and documents servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
