Proxmox VE MCP
An MCP server for Proxmox VE that allows agents to query VM status, storage, and backups, and perform power management and snapshot actions with a confirmation step before changes.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
It runs against any Proxmox VE 8 or 9 through its REST API, with an API token.
Vendor documentation What you can do with it
- Query nodes, storage, and guest status
- Find VMs and containers by name or state
- Start, shut down, or reboot a guest
- Take a snapshot with a confirmation note
Source and maintenance
Community listingRegistry 0.1.0
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
mojood-proxmox-mcp 0.1.0
pypiuvx
mojood-proxmox-mcp package definition
{
"version": "0.1.0",
"transport": "stdio",
"identifier": "mojood-proxmox-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"packageArguments": [
{
"type": "positional",
"value": "--stdio",
"valueHint": "--stdio"
}
],
"environmentVariables": [
{
"name": "PVE_URL",
"isRequired": true,
"description": "Your Proxmox VE API address"
},
{
"name": "PVE_TOKEN_ID",
"isRequired": true,
"description": "API token id (user@realm!name)"
},
{
"name": "PVE_TOKEN_SECRET",
"isRequired": true,
"description": "API token secret"
},
{
"name": "PVE_SAMPLE",
"description": "0 for real data (1 labels answers SAMPLE)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
Cursor configuration
{
"mcpServers": {
"proxmox-ve-mcp-mojood-proxmox-mcp": {
"command": "uvx",
"args": [
"mojood-proxmox-mcp==0.1.0",
"--stdio"
],
"env": {
"PVE_URL": "<YOUR_PVE_URL>",
"PVE_TOKEN_ID": "<YOUR_PVE_TOKEN_ID>",
"PVE_TOKEN_SECRET": "<YOUR_PVE_TOKEN_SECRET>",
"PVE_SAMPLE": "<YOUR_PVE_SAMPLE>"
}
}
}
}Cline
Cline configuration
{
"mcpServers": {
"proxmox-ve-mcp-mojood-proxmox-mcp": {
"command": "uvx",
"args": [
"mojood-proxmox-mcp==0.1.0",
"--stdio"
],
"env": {
"PVE_URL": "<YOUR_PVE_URL>",
"PVE_TOKEN_ID": "<YOUR_PVE_TOKEN_ID>",
"PVE_TOKEN_SECRET": "<YOUR_PVE_TOKEN_SECRET>",
"PVE_SAMPLE": "<YOUR_PVE_SAMPLE>"
}
}
}
}VS Code
VS Code configuration
{
"servers": {
"proxmox-ve-mcp-mojood-proxmox-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mojood-proxmox-mcp==0.1.0",
"--stdio"
],
"env": {
"PVE_URL": "<YOUR_PVE_URL>",
"PVE_TOKEN_ID": "<YOUR_PVE_TOKEN_ID>",
"PVE_TOKEN_SECRET": "<YOUR_PVE_TOKEN_SECRET>",
"PVE_SAMPLE": "<YOUR_PVE_SAMPLE>"
}
}
}
}Claude Desktop
Claude Desktop configuration
{
"mcpServers": {
"proxmox-ve-mcp-mojood-proxmox-mcp": {
"command": "uvx",
"args": [
"mojood-proxmox-mcp==0.1.0",
"--stdio"
],
"env": {
"PVE_URL": "<YOUR_PVE_URL>",
"PVE_TOKEN_ID": "<YOUR_PVE_TOKEN_ID>",
"PVE_TOKEN_SECRET": "<YOUR_PVE_TOKEN_SECRET>",
"PVE_SAMPLE": "<YOUR_PVE_SAMPLE>"
}
}
}
}Let your agent find its tools
Find servers like Proxmox VE MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.