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, crate unraid-rmcp on 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:read scope, mutating actions need unraid:admin scope.
  • Rust MCP supports projection modes: legacy (default), atomic, or both.

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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/dinglebear-aiunraid.svg)](https://yunodb.com/tools/dinglebear-aiunraid?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/dinglebear-aiunraid?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/dinglebear-aiunraid.svg" alt="Featured on YunoDB" height="20"></a>