Proxmox VE MCP Server

Manage Proxmox VE through AI assistants. Its 40 documented tools cover pve, qemu, lxc, node. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-13 · ★ 19 · #150 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Proxmox VE MCP Server

before you install - you'll need

Set PVE_TOKEN_ID, PVE_TOKEN_SECRET, PVE_VERIFY_SSL before connecting. PVE_BASE_URL, MCP_TRANSPORT are optional or environment-specific per the README.

Claude Code

claude mcp add samik081-mcp-pve -- npx -y @samik081/mcp-pve

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "samik081-mcp-pve": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-pve"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

npm package @samik081/mcp-pve - published under the repo owner's npm scope (@samik081)

registry namespace io.github.Samik081 is GitHub-verified and matches the repo owner

03 · What Proxmox VE MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all nodes in the cluster, get detailed node status (CPU, memory, uptime, load), get time and timezone info for a node, and get system log entries from a node.

The 40 tools it gives your agent

Extracted from the project's README - what Proxmox VE MCP Server lets an agent do.

pve_list_nodes
- List all nodes in the cluster
pve_get_node_status
- Get detailed node status (CPU, memory, uptime, load)
pve_get_node_version
- Get PVE version info for a node
pve_get_node_dns
- Get DNS settings for a node
pve_get_node_time
- Get time and timezone info for a node
pve_get_node_syslog
- Get system log entries from a node
pve_list_node_services
- List all system services on a node
pve_manage_node_service
- Start, stop, restart, or reload a node service
pve_list_qemu_vms
- List all QEMU VMs on a node
pve_get_qemu_status
- Get current VM status (CPU, memory, disk, network)
pve_get_qemu_config
- Get VM configuration
pve_get_qemu_rrddata
- Get RRD statistics over a time period
show all 40 tools
pve_list_qemu_snapshots
- List all VM snapshots
pve_start_qemu_vm
- Start a VM
pve_stop_qemu_vm
- Stop a VM (immediate)
pve_shutdown_qemu_vm
- Gracefully shut down a VM
pve_reboot_qemu_vm
- Reboot a VM
pve_suspend_qemu_vm
- Suspend a VM
pve_resume_qemu_vm
- Resume a suspended VM
pve_reset_qemu_vm
- Reset a VM (hard)
pve_migrate_qemu_vm
- Migrate a VM to another node
pve_create_qemu_vm
- Create a new VM
pve_delete_qemu_vm
- Delete a VM and all its data
pve_update_qemu_config
- Update VM configuration
pve_clone_qemu_vm
- Clone a VM
pve_create_qemu_snapshot
- Create a VM snapshot
pve_delete_qemu_snapshot
- Delete a VM snapshot
pve_rollback_qemu_snapshot
- Rollback a VM to a snapshot
pve_list_lxc_containers
- List all LXC containers on a node
pve_get_lxc_status
- Get current container status
pve_get_lxc_config
- Get container configuration
pve_get_lxc_rrddata
- Get RRD statistics over a time period
pve_list_lxc_snapshots
- List all container snapshots
pve_start_lxc_container
- Start a container
pve_stop_lxc_container
- Stop a container (immediate)
pve_shutdown_lxc_container
- Gracefully shut down a container
pve_reboot_lxc_container
- Reboot a container
pve_suspend_lxc_container
- Suspend (freeze) a container
pve_resume_lxc_container
- Resume (unfreeze) a container
pve_create_lxc_container
- Create a new container

Latest releases

v0.8.0 · 2026-08-13

bump MCP SDK to 1.30.0 and TypeScript to 7.0, require Node >=22.12 · LXC features/onboot/tags/startup params and API token management tools · eliminate flaky EADDRINUSE failures in HTTP server tests

v0.7.0 · 2026-07-15

add docker job timeout and make npm publish idempotent · PVE 9.2 compatibility - bulk actions, OCI pull, HA rules & arm/disarm

v0.6.1 · 2026-06-29

bump @modelcontextprotocol/sdk 1.27→1.29, zod, biome, typescript, vitest

04 · Who maintains Proxmox VE MCP Server

Proxmox VE MCP Server is maintained by samik081. We track 4 MCP servers from samik081 - 4 actively maintained, 35 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from samik081.

  1. AdGuard Home MCP Server Manage AdGuard Home through AI assistants ★ 4
  2. Authentik MCP Server Manage Authentik through AI assistants ★ 6

05 · Facts

repository
github.com/samik081/mcp-pve
category
other - ranked #150 of 848 actively-maintained other servers as of 2026-08-25.
release cadence
3 releases in the last 90 days (latest 2026-08-13)
registry
io.github.Samik081/mcp-pve (active, first published 2026-03-09 · 7 versions)
packages
npm:@samik081/mcp-pve · oci:ghcr.io/samik081/mcp-pve:0.8.0

06 · Proxmox VE MCP Server FAQ

Is Proxmox VE MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-13 and it shipped 3 releases in the last 90 days. We re-verify nightly.

What can Proxmox VE MCP Server do?

With this server connected, an agent can list all nodes in the cluster, get detailed node status (CPU, memory, uptime, load), get time and timezone info for a node, and get system log entries from a node.

How do I install Proxmox VE MCP Server?

Run `npx -y @samik081/mcp-pve`. The README documents 5 environment variables (PVE_BASE_URL, PVE_TOKEN_ID, PVE_TOKEN_SECRET…) to set first. Set PVE_TOKEN_ID, PVE_TOKEN_SECRET, PVE_VERIFY_SSL before connecting. PVE_BASE_URL, MCP_TRANSPORT are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Proxmox VE MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Proxmox VE MCP Server

Alternatives to Proxmox VE MCP Server

Maintained other servers if Proxmox VE MCP Server isn't the fit.

  1. Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,204 · 2026-08-24
  2. Server Commands An MCP server to run arbitrary commands ★ 38,704 · 2026-08-05
  3. Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 4,780 · 2026-08-25
  4. Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,460 · 2026-08-25
  5. Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,598 · 2026-08-21
  6. Ship Swift 40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP. ★ 2,968 · 2026-08-09

More MCP servers to compare · reMarkable MCP Server · Nfse Nacional · Agentic SSH · Sandbox API · Sanity

More TypeScript MCP servers · Transcriptor MCP · Banco Inter · SandBase Harness · Kronan MCP · see all