unraidQuery and monitor Unraid servers via the GraphQL API. Use when the user asks to 'check Unraid', 'monitor Unraid', 'Unraid API', 'get Unraid status', 'check disk temperatures', 'read Unraid logs', 'list Unraid shares', 'Unraid array status', 'Unraid containers', 'Unraid VMs', or mentions Unraid system monitoring, disk health, parity checks, or server status.
Install via ClawdBot CLI:
clawdbot install jmagar/unraidQuery and monitor Unraid servers using the GraphQL API. Access all 27 read-only endpoints for system monitoring, disk health, logs, containers, VMs, and more.
Set your Unraid server credentials:
export UNRAID_URL="https://your-unraid-server/graphql"
export UNRAID_API_KEY="your-api-key"Get API Key: Settings ā Management Access ā API Keys ā Create (select "Viewer" role)
Use the helper script for any query:
./scripts/unraid-query.sh -q "{ online }"Or run example scripts:
./scripts/dashboard.sh # Complete multi-server dashboard
./examples/disk-health.sh # Disk temperatures & health
./examples/read-logs.sh syslog 20 # Read system logsUnraid 7.2+ uses GraphQL (not REST). Key differences:
/graphql for all queriesinfo - Static hardware specs (CPU model, cores, OS version)metrics - Real-time usage (CPU %, memory %, current load)Always use metrics for monitoring, info for specifications.
Check if server is online:
./scripts/unraid-query.sh -q "{ online }"Get CPU and memory usage:
./scripts/unraid-query.sh -q "{ metrics { cpu { percentTotal } memory { used total percentTotal } } }"Complete dashboard:
./scripts/dashboard.shCheck disk health and temperatures:
./examples/disk-health.shGet array status:
./scripts/unraid-query.sh -q "{ array { state parityCheckStatus { status progress errors } } }"List all physical disks (including cache/USB):
./scripts/unraid-query.sh -q "{ disks { name } }"List network shares:
./scripts/unraid-query.sh -q "{ shares { name comment } }"List available logs:
./scripts/unraid-query.sh -q "{ logFiles { name size modifiedAt } }"Read log content:
./examples/read-logs.sh syslog 20List Docker containers:
./scripts/unraid-query.sh -q "{ docker { containers { names image state status } } }"List VMs:
./scripts/unraid-query.sh -q "{ vms { name state cpus memory } } }"Note: Container output logs are NOT accessible via API. Use docker logs via SSH.
Get notification counts:
./scripts/unraid-query.sh -q "{ notifications { overview { unread { info warning alert total } } } }"The scripts/unraid-query.sh helper supports:
# Basic usage
./scripts/unraid-query.sh -u URL -k API_KEY -q "QUERY"
# Use environment variables
export UNRAID_URL="https://unraid.local/graphql"
export UNRAID_API_KEY="your-key"
./scripts/unraid-query.sh -q "{ online }"
# Format options
-f json # Raw JSON (default)
-f pretty # Pretty-printed JSON
-f raw # Just the data (no wrapper)For detailed documentation, consult:
references/endpoints.md - Complete list of all 27 API endpointsreferences/troubleshooting.md - Common errors and solutionsreferences/api-reference.md - Detailed field documentationscripts/unraid-query.sh - Main GraphQL query toolscripts/dashboard.sh - Automated multi-server inventory reporter# System status
./scripts/unraid-query.sh -q "{ online metrics { cpu { percentTotal } } }"
# Disk health
./examples/disk-health.sh
# Array status
./scripts/unraid-query.sh -q "{ array { state } }"
# Read logs
./examples/read-logs.sh syslog 20
# Complete dashboard
./scripts/dashboard.sh
# List shares
./scripts/unraid-query.sh -q "{ shares { name } }"
# List containers
./scripts/unraid-query.sh -q "{ docker { containers { names state } } }"Generated Mar 1, 2026
Home users running Unraid for media servers, game servers, or personal cloud storage can use this skill to monitor system health, disk temperatures, and array status. It helps prevent data loss by alerting to disk failures or overheating, and tracks resource usage to optimize performance for applications like Plex or game servers.
Small businesses using Unraid for file sharing, backup servers, or lightweight virtualization can employ this skill to monitor server uptime, check for notifications, and manage Docker containers or VMs. It enables IT staff to quickly assess system status and troubleshoot issues without direct server access, improving operational efficiency.
Media production studios utilizing Unraid for centralized storage of video, audio, and project files can leverage this skill to monitor disk health and array parity checks. It ensures data integrity for critical assets, helps plan maintenance during downtime, and tracks storage usage across network shares to manage capacity.
Research labs using Unraid to store experimental data, run computational simulations via containers, or host virtual machines for analysis can use this skill to monitor CPU and memory usage, check container states, and read system logs. It supports proactive maintenance to avoid disruptions in data collection or processing workflows.
Managed service providers (MSPs) supporting clients with Unraid servers can integrate this skill into their monitoring dashboards to track multiple servers' online status, disk health, and notification counts. It automates routine checks, reduces manual intervention, and provides alerts for issues like parity errors or high resource usage across client deployments.
Offer a cloud-based dashboard that aggregates data from multiple Unraid servers using this skill, providing users with real-time alerts, historical trends, and automated reports. Revenue is generated through monthly or annual subscriptions, with tiers based on the number of servers monitored or features like advanced analytics.
Provide consulting services to help businesses set up and customize this skill for their specific Unraid monitoring needs, such as integrating it with existing IT tools or developing custom scripts. Revenue comes from one-time project fees or ongoing support contracts, targeting organizations lacking in-house expertise.
License this skill to hardware vendors selling pre-configured Unraid servers, embedding it as a value-added feature for remote management and monitoring. Revenue is generated through licensing fees per unit sold or annual partnerships, enhancing product differentiation and customer retention for vendors.
š¬ Integration Tip
Integrate this skill with existing monitoring tools like Grafana or Prometheus by using the helper scripts to export data, and ensure API keys are securely managed via environment variables or secret stores.
Manage torrents with qBittorrent. Use when the user asks to "list torrents", "add torrent", "pause torrent", "resume torrent", "delete torrent", "check download status", "torrent speed", "qBittorrent stats", or mentions qBittorrent/qbit torrent management.
Search indexers and manage Prowlarr. Use when the user asks to "search for a torrent", "search indexers", "find a release", "check indexer status", "list indexers", "prowlarr search", "sync indexers", or mentions Prowlarr/indexer management.
Interact with Uptime Kuma monitoring server. Use for checking monitor status, adding/removing monitors, pausing/resuming checks, viewing heartbeat history. Triggers on mentions of Uptime Kuma, server monitoring, uptime checks, or service health monitoring.
Backup Clawdbot workspace and config to GitHub with git-crypt encryption. Use for daily automated backups or manual backup/restore operations.
Manage TrueNAS SCALE via API. Check pool health, manage datasets and snapshots, monitor alerts, control services, manage apps, orchestrate Dockge container stacks, and manage bookmarks. Use when the user asks about their NAS, storage, backups, containers, bookmarks, or homelab services.
CLI tool for interacting with Atlassian Jira and Confluence