unraid

Query Unraid server health and metrics via the GraphQL API.

69|7|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/jmagar/claude-homelab --skill unraid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unraid
Source: https://github.com/jmagar/claude-homelab/tree/main/skills/unraid
Command: npx skills add https://github.com/jmagar/claude-homelab --skill unraid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, curl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Query Unraid servers efficiently to monitor health, status, and resource metrics across multiple endpoints, simplifying administration and alerting.

Core Features & Use Cases

  • Unified visibility: Access 27 read-only Unraid GraphQL endpoints (system, storage, virtualization, logs, and more) through a single entry point.
  • Dashboard-ready data: Retrieve metrics, disk health, shares, containers, and VMs to feed dashboards or automation workflows.
  • Use Case: If you manage multiple Unraid servers, quickly aggregate health reports and push alerts using Claude Code.

Quick Start

Run the provided helper script against your Unraid server to query health data and render a compact report.

Frequently Asked Questions about unraid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor Unraid server health using the GraphQL API?

You can monitor Unraid server health by querying 27 read-only GraphQL endpoints to retrieve system info, storage metrics, docker containers, VMs, and logs. The Skill uses a helper script to execute queries and requires your server URL and a viewer API key.

What environment variables do I need to query Unraid server status?

To query Unraid server status, you need to set the UNRAID_URL and UNRAID_API_KEY environment variables or pass them as flags. The API key must have viewer permissions to authenticate GraphQL API requests successfully.

Can I retrieve Unraid disk health and Docker container metrics for dashboards?

Yes, you can retrieve Unraid disk health, storage metrics, Docker containers, VMs, shares, and notifications via GraphQL endpoints. This dashboard-ready data can be fed directly into monitoring workflows or automation pipelines to aggregate health reports.

How do I check Unraid system logs and notifications from the command line?

You can check Unraid system logs and notifications by running the provided unraid-query.sh helper script against your server. The script uses curl and jq to execute GraphQL queries and parse the returned health, status, and resource metric data.

Does this Unraid monitoring approach support multiple servers?

Yes, if you manage multiple Unraid servers, you can quickly aggregate health reports across all of them by running queries against each server's GraphQL API. This allows you to push centralized alerts and maintain unified visibility using Claude Code.

What are the limitations of using GraphQL endpoints for Unraid monitoring?

The GraphQL endpoints provide 27 read-only queries covering system, storage, virtualization, and logs, meaning you can retrieve health and status metrics but cannot execute configuration changes. You also need jq and curl installed locally to run the helper script.