Proxmox VE MCP Server

● Active

io.github.Samik081/mcp-pve

Manage Proxmox VE through AI assistants

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mcp-pve": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-pve@0.11.0"
      ],
      "env": {
        "PVE_BASE_URL": "<your PVE_BASE_URL>",
        "PVE_TOKEN_ID": "<your PVE_TOKEN_ID>",
        "PVE_TOKEN_SECRET": "<your PVE_TOKEN_SECRET>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env PVE_BASE_URL='<your PVE_BASE_URL>' --env PVE_TOKEN_ID='<your PVE_TOKEN_ID>' --env PVE_TOKEN_SECRET='<your PVE_TOKEN_SECRET>' --transport stdio mcp-pve -- npx -y @samik081/mcp-pve@0.11.0
OpenAI Codex CLI
codex mcp add mcp-pve --env PVE_BASE_URL='<your PVE_BASE_URL>' --env PVE_TOKEN_ID='<your PVE_TOKEN_ID>' --env PVE_TOKEN_SECRET='<your PVE_TOKEN_SECRET>' -- npx -y @samik081/mcp-pve@0.11.0
VS Code
code --add-mcp '{"name":"mcp-pve","type":"stdio","command":"npx","args":["-y","@samik081/mcp-pve@0.11.0"],"env":{"PVE_BASE_URL":"<your PVE_BASE_URL>","PVE_TOKEN_ID":"<your PVE_TOKEN_ID>","PVE_TOKEN_SECRET":"<your PVE_TOKEN_SECRET>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • PVE_BASE_URLrequiredURL of the Proxmox VE instance (e.g. https://pve.example.com:8006)
  • PVE_TOKEN_IDrequiredsecretProxmox VE API token ID (e.g. user@pam!token-name)
  • PVE_TOKEN_SECRETrequiredsecretProxmox VE API token secret

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Cloud & DevOps
Version
0.11.0
Registry
active
Published
11/12/2026

On GitHub

read Nov 17, 2026
Stars
27
Forks
4
Last push
Nov 12, 2026
License
MIT

TypeScriptclaude-codecoding-assistantmcpmcp-servermodel-context-protocolproxmoxproxmox-vepve

From the README

MCP PVE MCP server for Proxmox VE. Manage virtual machines, containers, storage, networking, and clusters through natural language in Cursor, Claude Code, and Claude Desktop. Features • 129 tools across 12 categories covering the Proxmox VE REST API • Three access tiers (read-only, read-execute, full) for granular control • Category filtering via PVE_CATEGORIES to expose only the tools you need • Zero HTTP dependencies -- uses native fetch (Node 22+) • Self-signed cert support via PVEVERIFYSSL=false • Docker images for linux/amd64 and linux/arm64 on GHCR • Remote MCP via HTTP transport (MCP_TRANSPORT=http) using the Streamable HTTP protocol • TypeScript/ESM with full type safety API Compatibility Tested with Proxmox VE 9.2.4. Quick Start Run the server directly with npx: The server validates your PVE connection on startup and fails immediately with a clear error if credentials are missing or invalid. Docker Run with Docker (stdio transport, same as npx): To run as a remote MCP server with HTTP transport: The MCP endpoint is available at http://localhost:3000 and a health check at http://localhost:3000/health. Security: the HTTP transport has no authentication -- anyone who can reach the port can call every enabled tool. Keep it on loopback or a trusted network, or put it behind an authenticating reverse proxy. Outside Docker the server binds to 127.0.0.1 by default and only accepts requests whose Host/Origin is a loopback name (DNS rebinding protection).…

Read the full README on GitHub →

Alternatives to Proxmox VE MCP Server

Best Cloud & DevOps servers →

The most-starred Cloud & DevOps servers in the index, with their live-check result.

ServerStarsLast pushLive check
Netdata81,426Nov 2026Needs sign-in
kubeshark MCP12,146Nov 2026Local / not checked
OneUptime7,820Nov 2026Working
cloudflare.mcp MCP4,473Oct 2026Working
Radar Kubernetes MCP Server4,129Nov 2026Local / not checked

Proxmox VE MCP Server: questions people ask

Is Proxmox VE MCP Server a remote or a local MCP server?
According to its entry in the official MCP registry, Proxmox VE MCP Server ships as a local package (npm, Docker) that your client starts on your machine.
Does Proxmox VE MCP Server need an API key?
Its registry entry declares 6 required environment variables: PVE_BASE_URL, PVE_TOKEN_ID, PVE_TOKEN_SECRET, PVE_BASE_URL…. The config on this page shows where each goes.
Is Proxmox VE MCP Server still maintained?
Active: the repository's last commit 7 days ago. Last push Nov 12, 2026, 27 GitHub stars, MIT licence. Read from GitHub on Nov 17, 2026.
How do I add Proxmox VE MCP Server to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Cloud & DevOps →

Add the badge to your site

Show visitors that Proxmox VE MCP Server is listed here — it’s also the link we check for a free listing.

Proxmox VE MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-samik081-mcp-pve?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Proxmox VE MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Proxmox VE MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-samik081-mcp-pve?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.