unraid
Query, monitor, and manage Unraid servers via GraphQL API through MCP tools. Supports system info, Docker, VMs, array/parity, notifications, plugins, rclone, an
What is unraid?
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.
Overview of unraid
What it is
Unraid is a monorepo of tooling for Unraid servers, providing two MCP servers (Python and Rust) and three Unraid OS plugins, plus Claude/Codex agent integrations. It allows querying, monitoring, and managing Unraid servers via a GraphQL API through MCP tools. The repository was renamed from unraid-mcp to unraid on 2026-07-27, and the former standalone runraid and incus-unraid repos were merged in here. The PyPI package, container image, Claude plugin, and Unraid .plg are all still named unraid-mcp.
Key features
- Supports system info, Docker, VMs, array/parity, notifications, plugins, rclone, and live telemetry via GraphQL API.
- Two MCP servers: a Python server (flagship, published to PyPI as
unraid-mcp) and a Rust server (single static binary, crateunraid-rmcpon crates.io, plus npm launcher@dinglebear/unraid). - Three Unraid OS plugins: MCP plugin (ships Rust server), Incus plugin (runs Incus system containers with NestJS/GraphQL backend), and Codex plugin (embeds a Codex chathead app-server).
- Agent plugins for Claude Code and Codex, with no manual credential steps: settings are mapped directly into the server environment via
${user_config.*}. - Rust server exposes both queries and mutations; read actions need
unraid:readscope, mutating actions needunraid:adminscope. - Rust MCP supports projection modes:
legacy(default),atomic, orboth.
Use cases
- Querying and monitoring Unraid server system information, Docker containers, VMs, array/parity status, notifications, plugins, and rclone operations.
- Managing Unraid servers programmatically via MCP tools, including VM and Docker lifecycle, array start/stop, and notification writes.
- Running Incus system containers (dev containers) firewalled off the LAN on an Unraid box.
- Embedding a Codex chathead app-server on an Unraid server.
Getting started
For the Python MCP server (flagship), see the unraid-py/README.md and unraid-py/docs/ for full documentation. It launches with uvx unraid-mcp.For the Rust MCP server + CLI:bashcargo install --path unraid-rs --locked # from the repository root# Configure UNRAID_API_URL and UNRAID_API_KEY privately before querying.runraid setup check # inspect setup without repairing filesrunraid array # read array staterunraid serve mcp # MCP HTTP (default :40010; configure auth)For agent plugin installation (one marketplace command, two manifests):text/plugin marketplace add dinglebear-ai/unraid/plugin install unraid-mcp@unraid-mcp # Python server/plugin install runraid@unraid-mcp # Rust server
License and pricing
License: MIT. Pricing: open source (not stated).
Based on the project's public README and repository metadata.