Unraid MCP

Name: Unraid MCP
Author: dinglebear

dinglebear

Query, monitor, and manage Unraid servers via GraphQL API through MCP tools. Supports system info, Docker, VMs, array/parity, notifications, plugins, rclone, and live telemetry.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add unraid --env UNRAID_API_URL='<UNRAID_API_URL>' --env UNRAID_API_KEY='<UNRAID_API_KEY>' --env CLAUDE_MCP_SERVER='<CLAUDE_MCP_SERVER>' --env LOG_LEVEL='<LOG_LEVEL>' -- npx -y @dinglebear/unraid mcp

~/.codex/config.toml

[mcp_servers.unraid]
command = "npx"
args = ["-y", "@dinglebear/unraid", "mcp"]
env = { UNRAID_API_URL = "<UNRAID_API_URL>", UNRAID_API_KEY = "<UNRAID_API_KEY>", CLAUDE_MCP_SERVER = "<CLAUDE_MCP_SERVER>", LOG_LEVEL = "<LOG_LEVEL>" }

# codex mcp add unraid --env UNRAID_API_URL='<UNRAID_API_URL>' --env UNRAID_API_KEY='<UNRAID_API_KEY>' --env CLAUDE_MCP_SERVER='<CLAUDE_MCP_SERVER>' --env LOG_LEVEL='<LOG_LEVEL>' -- npx -y @dinglebear/unraid mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>",
        "CLAUDE_MCP_SERVER": "<CLAUDE_MCP_SERVER>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "unraid": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>",
        "CLAUDE_MCP_SERVER": "<CLAUDE_MCP_SERVER>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>",
        "CLAUDE_MCP_SERVER": "<CLAUDE_MCP_SERVER>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>",
        "CLAUDE_MCP_SERVER": "<CLAUDE_MCP_SERVER>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>",
        "CLAUDE_MCP_SERVER": "<CLAUDE_MCP_SERVER>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

Environment variables

UNRAID_API_URL
UNRAID_API_KEY
CLAUDE_MCP_SERVER
LOG_LEVEL

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related