Nandi Proxmox MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "PROXMOX_HOST=${PROXMOX_HOST}" -e "PROXMOX_USER=${PROXMOX_USER}" -e "TOKEN_NAME=${TOKEN_NAME}" -e "TOKEN_SECRET=${TOKEN_SECRET}" proxmox-mcp -- npx -y nandi-proxmox-mcp run
Required:PROXMOX_HOSTPROXMOX_USERTOKEN_NAMETOKEN_SECRET
README.md

Open source MCP Server for Proxmox, powered by NANDI Services.

nandi-proxmox-mcp

Open source MCP Server for Proxmox, powered by NANDI Services.

nandi-proxmox-mcp lets users connect to their own Proxmox server and operate nodes, VMs, and CT/LXC securely via MCP tools in VS Code.

Important: API token ownership

The Proxmox API token is not delivered by npm, VS Code, or this MCP package. Each user must create a token in their own Proxmox environment with minimum ACL permissions.

5-minute Quickstart (Windows)

  1. Install Node.js 20+.
  2. Run npm install -g nandi-proxmox-mcp.
  3. Run nandi-proxmox-mcp setup and complete guided onboarding.
  4. Run nandi-proxmox-mcp doctor --check mcp-config,nodes,vms,cts,node-status,remote-op.
  5. Open VS Code and confirm MCP server is registered (.vscode/mcp.json).

Alternative direct run:

  • npx nandi-proxmox-mcp setup
  • npx nandi-proxmox-mcp run

Fastest repeatable setup for an existing Proxmox server:

npx nandi-proxmox-mcp setup `
  --proxmox-host  `
  --proxmox-user  `
  --token-name <TOKEN_NAME> `
  --token-secret "<TOKEN_SECRET>" `
  --ssh-key-path "$env:USERPROFILE\\.ssh\\id_ed25519" `
  --skip-connectivity

Fast doctor against a real container:

npx nandi-proxmox-mcp doctor `
  --check mcp-config,nodes,vms,cts,node-status,remote-op `
  --ctid <CTID>

One-command Windows install:

powershell -ExecutionPolicy Bypass -File .\scripts\setup-win.ps1 `
  -ProxmoxHost  `
  -ProxmoxUser  `
  -TokenName <TOKEN_NAME> `
  -TokenSecret "<TOKEN_SECRET>" `
  -DoctorCtid <CTID>

VS Code / Codex plug-and-play paths

  • Custom server: use .vscode/mcp.json (root servers format).
  • Manifest install: use mcp-manifest.json.
  • User-level config template: templates/vscode.user.mcp.template.json.

Install from MCP marketplace / plugin marketplace

The npm package is already public, but marketplace discovery has an additional submission process.

  • MCP marketplace (@mcp in VS Code): submit server metadata + mcp-manifest.json + npm package reference.
  • Codex/VS Code recommended servers: publish the corresponding Agent Plugin in the configured plugin marketplace.

Submission metadata and assets are prepared in:

  • marketplace/listing.md
  • marketplace/security.md
  • marketplace/icon.png
  • marketplace/screenshot-setup.png
  • marketplace/mcp-registry/server.json
  • marketplace/agent-plugin-marketplace/.github/plugin/marketplace.json

MCP tools included

  • Inventory: listNodes, listVMs, listContainers
  • Status: getNodeStatus, getVMStatus, getContainerStatus
  • Control: startVM, stopVM, startContainer, stopContainer
  • CT operations: execInContainer, dockerPsInContainer, dockerLogsInContainer, runRemoteDiagnostic, sshBatchDiagnostics

Security principles

  • No hardcoded host/token secrets in versioned files.
  • Local sensitive config generated in .nandi-proxmox-mcp/config.json.
  • Templates with placeholders only.
  • CI includes secret scanning and dependency scanning.

Docs

Development

  • npm ci
  • npm run lint
  • npm run typecheck
  • npm test
  • npm run build

License

MIT. See LICENSE.

Tools (11)

listNodesList all nodes in the Proxmox environment
listVMsList all virtual machines
listContainersList all LXC containers
getNodeStatusGet status of a specific node
getVMStatusGet status of a specific virtual machine
getContainerStatusGet status of a specific container
startVMStart a virtual machine
stopVMStop a virtual machine
startContainerStart a container
stopContainerStop a container
execInContainerExecute a command inside a container

Environment Variables

PROXMOX_HOSTrequiredThe URL or IP address of the Proxmox server
PROXMOX_USERrequiredThe Proxmox API user
TOKEN_NAMErequiredThe name of the Proxmox API token
TOKEN_SECRETrequiredThe secret value of the Proxmox API token

Configuration

claude_desktop_config.json
{"mcpServers": {"proxmox": {"command": "npx", "args": ["-y", "nandi-proxmox-mcp", "run"]}}}

Try it

→List all my virtual machines and tell me which ones are currently stopped.
→Start the virtual machine with ID 101.
→Check the status of my node and list all running containers.
→Execute 'docker ps' inside the container with ID 200.

Frequently Asked Questions

What are the key features of Nandi Proxmox MCP?

Inventory management for nodes, VMs, and containers. Real-time status monitoring for Proxmox resources. Remote control operations including start and stop. Container-specific diagnostics and command execution. Secure API token-based authentication.

What can I use Nandi Proxmox MCP for?

Automating VM power cycles during maintenance windows. Quickly checking resource status across multiple Proxmox nodes. Running diagnostic commands inside containers without manual SSH access. Integrating Proxmox infrastructure management into VS Code workflows.

How do I install Nandi Proxmox MCP?

Install Nandi Proxmox MCP by running: npm install -g nandi-proxmox-mcp

What MCP clients work with Nandi Proxmox MCP?

Nandi Proxmox MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Nandi Proxmox MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all cloud servers →

Related MCP Servers

SSH MCP Server
Execute shell commands on remote Linux and Windows systems via SSH.
cloud346 stars
Hono MCP Server
Expose your Hono API endpoints as MCP tools.
cloud77 stars
n8n Manager for AI Agents
Manage n8n workflow automation instances through AI agent tools.
cloud54 stars
Kilntainers
Give Every Agent an Ephemeral Linux Sandbox — via MCP
cloud36 stars
AWS MCP Server
Manage and provision AWS resources using natural language prompts
cloud27 stars
Dynamics 365 Finance & Operations
Production-ready MCP server for Microsoft Dynamics 365 Finance & Operations
cloud25 stars