Proxmox VE MCP Server
by akmalovaaio.github.akmalovaa/proxmox-mcpv2.3.0
Manage Proxmox VE nodes, VMs, containers, storage and snapshots. Read-only by default.
context tax
queued
security
queued
cold start
queued
freshness
Maintained37d ago
Install Proxmox VE MCP server
Install in Claude Code
claude mcp add proxmox-ve -e PROXMOX_HOST='<proxmox-host>' -e PROXMOX_TOKEN_VALUE='<proxmox-token-value>' -e PROXMOX_PASSWORD='<proxmox-password>' -e SENTRY_DSN='<sentry-dsn>' -- uvx proxmox-ve-mcpInstall in Cursor
{
"mcpServers": {
"proxmox-ve": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"proxmox-ve": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"proxmox-ve": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"proxmox-ve": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| PROXMOX_HOST | yes | — | Proxmox host IP or hostname. |
| PROXMOX_PORT | — | — | Proxmox API port. |
| PROXMOX_VERIFY_SSL | — | — | Verify the TLS certificate. Proxmox self-signs by default. |
| PROXMOX_TIMEOUT | — | — | Seconds to wait for each Proxmox API request. |
| PROXMOX_USER | — | — | API user, including the realm. |
| PROXMOX_TOKEN_NAME | — | — | API token name. Use this plus PROXMOX_TOKEN_VALUE, or PROXMOX_PASSWORD. |
| PROXMOX_TOKEN_VALUE | — | yes | API token secret. |
| PROXMOX_PASSWORD | — | yes | Password, used only when no API token is set. |
| PROXMOX_RISK_LEVEL | — | — | Which tools exist: read-only, plus lifecycle, or everything. |
| PROXMOX_TOOLS_ALLOW | — | — | Comma-separated tool names to register, intersected with the risk level. Unset = all of them. |
| PROXMOX_REDACT_SECRETS | — | — | Mask cipassword and sshkeys in every response. |
| PROXMOX_MCP_TRANSPORT | — | — | stdio (default) or streamable-http. |
| PROXMOX_MCP_HOST | — | — | HTTP bind address. Anything but loopback also needs PROXMOX_MCP_ALLOWED_HOSTS. |
| PROXMOX_MCP_PORT | — | — | HTTP port. |
| PROXMOX_MCP_PATH | — | — | Streamable HTTP endpoint path. |
| PROXMOX_MCP_JSON_RESPONSE | — | — | Answer with JSON instead of an SSE stream. |
| PROXMOX_MCP_ALLOWED_HOSTS | — | — | Comma-separated Host headers to accept over HTTP; '*' disables the check. |
| PROXMOX_MCP_ALLOWED_ORIGINS | — | — | Comma-separated browser origins allowed to call the endpoint. Empty = same-origin only. |
| SENTRY_DSN | — | yes | Optional: report tool traces and errors to Sentry. Unset disables it. |
Freshness
Maintained — last maintenance signal 37d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-02 · 37d ago · GitHub
Latest release
2026-09-01 · 39d ago · GitHub · 2.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-01 · 39d ago · official registry · v2.3.0
FAQ
›How do I install the Proxmox VE MCP server in Claude Code?
Run: claude mcp add proxmox-ve -e PROXMOX_HOST='<proxmox-host>' -e PROXMOX_TOKEN_VALUE='<proxmox-token-value>' -e PROXMOX_PASSWORD='<proxmox-password>' -e SENTRY_DSN='<sentry-dsn>' -- uvx proxmox-ve-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Proxmox VE require an API key?
Yes. It expects PROXMOX_HOST, PROXMOX_TOKEN_VALUE, PROXMOX_PASSWORD, SENTRY_DSN, of which 3 are secrets.
›Can I use Proxmox VE as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Proxmox VE in the official MCP registry?
Yes, as io.github.akmalovaa/proxmox-mcp.