unraid-mcp

Overview

Unraid MCP server transforms MCP tool calls into GraphQL queries and mutations, providing a unified interface for system inspection and management operations. It features live telemetry via WebSocket subscriptions that stream real-time data from the Unraid API. The server exposes extensive functionality including system monitoring, Docker container management, virtual machine control, parity checks, array operations, plugin management, rclone integration, and notification handling. All operations are gated through a single 'unraid' tool with action/subaction routing, with destructive actions requiring explicit confirmation.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• unraid

  Unified action/subaction router for all operations

  Try:Get server overview including OS, CPU, memory layout, and versionsTry:Check parity check progress and speedTry:Start a Docker container
• unraid_help

  Returns reference documentation as Markdown

  Try:Show me all available tools and their descriptionsTry:Get help for the system action group
• diagnose_subscriptions

  Full diagnostic dump of the WebSocket subscription system

  Try:Check subscription system status and errorsTry:Diagnose WebSocket connection issues
• test_subscription_query

  Probe a raw GraphQL subscription for schema/debug work

  Try:Test a subscription for CPU telemetryTry:Debug a live notifications feed
• disk

  Physical disk operations and details

  Try:Show me all physical disks in the arrayTry:Get details for disk with ID 1
• docker

  Container lifecycle and network inspection

  Try:List all running Docker containersTry:Start container with name plex
• vm

  Virtual machine lifecycle and management

  Try:List all virtual machinesTry:Start the Ubuntu VM
• notification

  System notification CRUD operations

  Try:Show me all unread notificationsTry:Archive all alert notifications
• plugin

  Unraid plugin management

  Try:List all installed pluginsTry:Install the docker man plugin
• rclone

  Cloud storage remote management

  Try:List all configured rclone remotesTry:Create a new Google Drive remote
• setting

  System settings management

  Try:Update system timezone settingTry:Configure UPS monitoring
• live

  Live telemetry data via WebSocket subscriptions

  Try:Show current CPU utilizationTry:Stream log file lines from /var/log/syslog

Comparable tools

Installation

pip install unraid-mcp

docker pull ghcr.io/jmagar/unraid-mcp:latest

{
  "mcpServers": {
    "unraid": {
      "command": "python",
      "args": ["-m", "unraid_mcp"],
      "env": {
        "UNRAID_API_URL": "http://your-unraid-server",
        "UNRAID_API_KEY": "your-api-key"
      }
    }
  }
}

FAQ

What authentication methods are supported?

The server supports API key authentication. You need to provide the Unraid API URL and API key in the environment variables.

Does this support live system monitoring?

Yes, it uses WebSocket subscriptions to provide live telemetry for CPU usage, memory, and other system metrics.

Compare unraid-mcp with