Better Unraid MCP

Local install

io.github.mswdev/better-unraid-mcpv0.1.1 GitHub verified

Monitor and manage an Unraid server from any MCP client: array, Docker, VMs, ZFS, logs, and UPS.

Cloud & DevOps

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-12T11:27:04.326999Z",
      "publishedAt": "2026-11-12T11:27:04.326999Z",
      "statusChangedAt": "2026-11-12T11:27:04.326999Z"
    }
  },
  "server": {
    "name": "io.github.mswdev/better-unraid-mcp",
    "title": "Better Unraid MCP",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.1.1",
    "packages": [
      {
        "version": "0.1.1",
        "transport": {
          "type": "stdio"
        },
        "identifier": "better-unraid-mcp",
        "registryType": "npm",
        "registryBaseUrl": "https://registry.npmjs.org",
        "environmentVariables": [
          {
            "name": "UNRAID_API_URL",
            "format": "string",
            "isRequired": true,
            "description": "Full Unraid GraphQL endpoint, including /graphql"
          },
          {
            "name": "UNRAID_API_KEY",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "Unraid API key (Settings → Management Access → API Keys)"
          },
          {
            "name": "UNRAID_SSH_HOST",
            "format": "string",
            "description": "Optional: SSH host for host-level tools"
          },
          {
            "name": "UNRAID_SSH_PASSWORD",
            "format": "string",
            "isSecret": true,
            "description": "Optional: SSH password (or set UNRAID_SSH_KEY_PATH)"
          },
          {
            "name": "MCP_READ_ONLY",
            "format": "boolean",
            "description": "Set true to register only read-only tools"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/mswdev/better-unraid-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/mswdev/better-unraid-mcp#readme",
    "description": "Monitor and manage an Unraid server from any MCP client: array, Docker, VMs, ZFS, logs, and UPS."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add better-unraid-mcp \
  -e UNRAID_API_URL=YOUR_UNRAID_API_URL \
  -e UNRAID_API_KEY=YOUR_UNRAID_API_KEY \
  -- npx -y [email protected]

Environment

UNRAID_API_URL (required): Full Unraid GraphQL endpoint, including /graphql
UNRAID_API_KEY (required): Unraid API key (Settings → Management Access → API Keys)
UNRAID_SSH_HOST (optional, not in the config above): Optional: SSH host for host-level tools
UNRAID_SSH_PASSWORD (optional, not in the config above): Optional: SSH password (or set UNRAID_SSH_KEY_PATH)
MCP_READ_ONLY (optional, not in the config above): Set true to register only read-only tools

Tools

We don't run packages, so we can't list this server's tools.