Query 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', 'lis
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Query 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 logs
Unraid 7.2+ uses GraphQL (not REST). Key differences:
/graphqlinfometricsAlways use
metricsinfoCheck 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.sh
Check disk health and temperatures:
./examples/disk-health.sh
Get 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 20
List 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 logsGet notification counts:
./scripts/unraid-query.sh -q "{ notifications { overview { unread { info warning alert total } } } }"
The
scripts/unraid-query.sh# 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.mdreferences/troubleshooting.mdreferences/api-reference.mdscripts/unraid-query.shscripts/dashboard.sh# 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 } } }"
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.