
MCP server
Proxmox VE
Manage Proxmox VE nodes, VMs, containers, storage and snapshots. Read-only by default.
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 2.3.0
- Listing updated
- 4 days ago
About Proxmox VE
Proxmox VE is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add proxmox-mcp --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' --env PROXMOX_PASSWORD='<PROXMOX_PASSWORD>' --env SENTRY_DSN='<SENTRY_DSN>' -- uvx proxmox-ve-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"proxmox-mcp": {
"command": "uvx",
"args": [
"proxmox-ve-mcp"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"SENTRY_DSN": "<SENTRY_DSN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"proxmox-mcp": {
"command": "uvx",
"args": [
"proxmox-ve-mcp"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"SENTRY_DSN": "<SENTRY_DSN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"proxmox-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-ve-mcp"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"SENTRY_DSN": "<SENTRY_DSN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"proxmox-mcp": {
"command": "uvx",
"args": [
"proxmox-ve-mcp"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"SENTRY_DSN": "<SENTRY_DSN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"proxmox-mcp": {
"command": "uvx",
"args": [
"proxmox-ve-mcp"
],
"env": {
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>",
"PROXMOX_PASSWORD": "<PROXMOX_PASSWORD>",
"SENTRY_DSN": "<SENTRY_DSN>"
}
}
}
}Configuration
PROXMOX_HOSTProxmox host IP or hostname.RequiredPROXMOX_PORTProxmox API port.PROXMOX_VERIFY_SSLVerify the TLS certificate. Proxmox self-signs by default.PROXMOX_TIMEOUTSeconds to wait for each Proxmox API request.PROXMOX_USERAPI user, including the realm.PROXMOX_TOKEN_NAMEAPI token name. Use this plus PROXMOX_TOKEN_VALUE, or PROXMOX_PASSWORD.PROXMOX_TOKEN_VALUEAPI token secret.PROXMOX_PASSWORDPassword, used only when no API token is set.PROXMOX_RISK_LEVELWhich tools exist: read-only, plus lifecycle, or everything.PROXMOX_TOOLS_ALLOWComma-separated tool names to register, intersected with the risk level. Unset = all of them.PROXMOX_REDACT_SECRETSMask cipassword and sshkeys in every response.PROXMOX_MCP_TRANSPORTstdio (default) or streamable-http.PROXMOX_MCP_HOSTHTTP bind address. Anything but loopback also needs PROXMOX_MCP_ALLOWED_HOSTS.PROXMOX_MCP_PORTHTTP port.PROXMOX_MCP_PATHStreamable HTTP endpoint path.PROXMOX_MCP_JSON_RESPONSEAnswer with JSON instead of an SSE stream.PROXMOX_MCP_ALLOWED_HOSTSComma-separated Host headers to accept over HTTP; '*' disables the check.PROXMOX_MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call the endpoint. Empty = same-origin only.SENTRY_DSNOptional: report tool traces and errors to Sentry. Unset disables it.PROXMOX_HOSTProxmox host IP or hostname.RequiredPROXMOX_PORTProxmox API port.PROXMOX_VERIFY_SSLVerify the TLS certificate. Proxmox self-signs by default.PROXMOX_TIMEOUTSeconds to wait for each Proxmox API request.PROXMOX_USERAPI user, including the realm.PROXMOX_TOKEN_NAMEAPI token name. Use this plus PROXMOX_TOKEN_VALUE, or PROXMOX_PASSWORD.PROXMOX_TOKEN_VALUEAPI token secret.PROXMOX_PASSWORDPassword, used only when no API token is set.PROXMOX_RISK_LEVELWhich tools exist: read-only, plus lifecycle, or everything.PROXMOX_TOOLS_ALLOWComma-separated tool names to register, intersected with the risk level. Unset = all of them.PROXMOX_REDACT_SECRETSMask cipassword and sshkeys in every response.PROXMOX_MCP_TRANSPORTstdio (default) or streamable-http.PROXMOX_MCP_HOSTHTTP bind address. Anything but loopback also needs PROXMOX_MCP_ALLOWED_HOSTS.PROXMOX_MCP_PORTHTTP port.PROXMOX_MCP_PATHStreamable HTTP endpoint path.PROXMOX_MCP_JSON_RESPONSEAnswer with JSON instead of an SSE stream.PROXMOX_MCP_ALLOWED_HOSTSComma-separated Host headers to accept over HTTP; '*' disables the check.PROXMOX_MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call the endpoint. Empty = same-origin only.SENTRY_DSNOptional: report tool traces and errors to Sentry. Unset disables it.
Pricing
Open source
Proxmox VE FAQ
Is Proxmox VE free?
Yes. Proxmox VE is open source, so you can use and self-host it for free.
How do I add Proxmox VE to Claude Code?
Run this command in your terminal: claude mcp add proxmox-mcp --env PROXMOX_HOST='<PROXMOX_HOST>' --env PROXMOX_TOKEN_VALUE='<PROXMOX_TOKEN_VALUE>' --env PROXMOX_PASSWORD='<PROXMOX_PASSWORD>' --env SENTRY_DSN='<SENTRY_DSN>' -- uvx proxmox-ve-mcp