Proxmox VE (Mojood Connect)

by askmojoodio.github.askmojood/proxmox-mcpv0.1.0

How the score works

Proxmox VE in Claude: VMs, storage, backups; start, stop, snapshot after a yes.

  • Runs on your machine

Version checks

  • Available on PyPI, latest 0.1.0 · checked

Not run yet – package checks are being switched on. It runs from a package on your machine, so instead of uptime we will install and start each new version.

How we check

Run it on your machine

Add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "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" }
    }
  }
}

Replace YOUR_PVE_URL,YOUR_PVE_TOKEN_ID,YOUR_PVE_TOKEN_SECRET with your own values.

For agents: the install prompt

Every step above as one Markdown text, for an assistant installing it for you.

# Install the MCP server Proxmox VE (Mojood Connect) (`io.github.askmojood/proxmox-mcp`)

Its page: https://plug.directory/servers/io.github.askmojood/proxmox-mcp

It runs on the person's machine and needs uv installed.

Ask the person for `YOUR_PVE_URL`, `YOUR_PVE_TOKEN_ID`, `YOUR_PVE_TOKEN_SECRET` and put it in place of the placeholder; never invent a value.

Use the section for the person's client.

## Claude Desktop, Cursor, Devin Desktop, Cline, LM Studio, Gemini CLI, mcp-client-cli, oterm, TUUI, BoltAI, AnythingLLM, Augment Code, Bob Shell, ECA, Kiro, Kiro CLI

Merge into the place for the person's client:

- Claude Desktop: claude_desktop_config.json (Settings › Developer › Edit Config)
- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- mcp-client-cli: ~/.llm/config.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- TUUI: resources/assets/config/mcp.json in the installed app
- BoltAI: ~/.boltai/mcp.json
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)
- Bob Shell: ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project
- Kiro: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)
- Kiro CLI: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)

```json
{
  "mcpServers": {
    "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" }
    }
  }
}
```

## Claude Code

Run in a terminal:

```sh
claude mcp add --env PVE_URL=YOUR_PVE_URL --env PVE_TOKEN_ID=YOUR_PVE_TOKEN_ID --env PVE_TOKEN_SECRET=YOUR_PVE_TOKEN_SECRET --transport stdio proxmox-mcp -- uvx mojood-proxmox-mcp==0.1.0 --stdio
```

## VS Code

Merge into .vscode/mcp.json:

```json
{
  "servers": {
    "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" }
    }
  }
}
```

## Zed

Merge into ~/.config/zed/settings.json:

```json
{
  "context_servers": {
    "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" }
    }
  }
}
```

## Continue

Merge into ~/.continue/config.yaml:

```yaml
mcpServers:
  - name: "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"
```

## Goose

Merge into ~/.config/goose/config.yaml:

```yaml
extensions:
  "proxmox-mcp":
    type: stdio
    name: "proxmox-mcp"
    enabled: true
    cmd: "uvx"
    args: ["mojood-proxmox-mcp==0.1.0", "--stdio"]
    env_keys: []
    envs: { "PVE_URL": "YOUR_PVE_URL", "PVE_TOKEN_ID": "YOUR_PVE_TOKEN_ID", "PVE_TOKEN_SECRET": "YOUR_PVE_TOKEN_SECRET" }
    timeout: 300
```

## Codex

Run in a terminal:

```sh
codex mcp add proxmox-mcp --env PVE_URL=YOUR_PVE_URL --env PVE_TOKEN_ID=YOUR_PVE_TOKEN_ID --env PVE_TOKEN_SECRET=YOUR_PVE_TOKEN_SECRET -- uvx mojood-proxmox-mcp==0.1.0 --stdio
```

## Agenvoy

Merge into ~/.config/agenvoy/mcp.json:

```json
{
  "servers": {
    "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" }
    }
  }
}
```

## Amp

Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):

```json
{
  "amp.mcpServers": {
    "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" }
    }
  }
}
```

Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.

From the publisher's entry in the Official MCP Registry (the registry entry). We have not checked this server yet. Report a problem