Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dinglebear-ai/unraid with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dinglebear-ai/unraid'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dinglebear-ai--unraid/badge.svg)](/listings/dinglebear-ai--unraid)

HTML

<a href="/listings/dinglebear-ai--unraid"><img src="/api/listings/dinglebear-ai--unraid/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add dinglebear-ai/unraid
/plugin install unraid-mcp@unraid-mcp   # Python server
/plugin install runraid@unraid-mcp      # Rust server

The `@unraid-mcp` suffix is the **marketplace name** declared in `.claude-plugin/marketplace.json`, not the repo name — it stays `unraid-mcp` even though the repo is now `dinglebear-ai/unraid`.

Both plugins are published from a single repo. Claude reads `.claude-plugin/marketplace.json`; Codex reads `.agents/plugins/marketplace.json`. `meta-ci.yml` asserts the two list the same plugin set, so they cannot drift.

`marketplace add` accepts the `owner/repo` shorthand (or a full git URL / local path). After install, Claude Code prompts for the connection settings (the plugin's `userConfig`).

Plugin credentials need no manual step

The agent plugins ship **no Claude Code hooks**, and none are needed: both `.mcp.json` files map your plugin settings into the server environment directly via `${user_config.*}`. `agents/unraid-rs` wires endpoint, TLS, authentication, and tool-selector settings; `agents/unraid-py` wires `UNRAID_API_URL` and `UNRAID_API_KEY`. Set them in plugin settings and the server picks them up on next launch.

Optional, for **non-plugin** installs (systemd, Docker) that want `~/.unraid/.env` written to disk:

runraid setup plugin-hook          # or: npx -y @dinglebear/unraid setup plugin-hook

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 58 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "unraid-mcp",
  4. "description": "Marketplace for the Unraid MCP plugin — query, monitor, and manage Unraid servers from Claude Code.",
  5. "owner": {
  6. "name": "Jacob Magar",
  7. "email": "jmagar@users.noreply.github.com",
  8. "url": "https://github.com/jmagar"
  9. },
  10. "plugins": [
  11. {
  12. "name": "unraid-mcp",
  13. "source": "./agents/unraid-py",
  14. "description": "Query, monitor, and manage Unraid servers via the Python MCP server (GraphQL). System info, Docker, VMs, array/parity, notifications, plugins, rclone, live telemetry.",
  15. "author": {
  16. "name": "Jacob Magar",
  17. "email": "jmagar@users.noreply.github.com",
  18. "url": "https://github.com/jmagar"
  19. },
  20. "homepage": "https://github.com/dinglebear-ai/unraid",
  21. "repository": "https://github.com/dinglebear-ai/unraid",
  22. "license": "MIT",
  23. "category": "infrastructure",
  24. "keywords": [
  25. "unraid",
  26. "homelab",
  27. "mcp",
  28. "graphql",
  29. "docker",
  30. "nas",
  31. "monitoring"
  32. ]
  33. },
  34. {
  35. "name": "runraid",
  36. "source": "./agents/unraid-rs",
  37. "description": "Unraid monitoring via the Rust MCP server + CLI (single static binary). Bearer/OAuth auth, systemd or Docker deployment.",
  38. "author": {
  39. "name": "Jacob Magar",
  40. "email": "jmagar@users.noreply.github.com",
  41. "url": "https://github.com/jmagar"
  42. },
  43. "homepage": "https://github.com/dinglebear-ai/unraid",
  44. "repository": "https://github.com/dinglebear-ai/unraid",
  45. "license": "MIT",
  46. "category": "infrastructure",
  47. "keywords": [
  48. "unraid",
  49. "homelab",
  50. "mcp",
  51. "rust",
  52. "cli",
  53. "nas",
  54. "monitoring"
  55. ]
  56. }
  57. ]
  58. }
README.md · README · 122 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Unraid
  2. <!-- mcp-name: tv.nashost/unraid-mcp -->
  3. [![PyPI](https://img.shields.io/pypi/v/unraid-mcp)](https://pypi.org/project/unraid-mcp/) [![ghcr.io](https://img.shields.io/badge/ghcr.io-dinglebear--ai%2Funraid--mcp-blue?logo=docker)](https://github.com/dinglebear-ai/unraid/pkgs/container/unraid-mcp)
  4. A monorepo of Unraid tooling: two MCP servers (Python and Rust) and three Unraid
  5. OS plugins, plus the Claude/Codex agent integrations that surface them.
  6. > **Repo name.** This repo was renamed `unraid-mcp` → `unraid` on 2026-07-27, and
  7. > the former standalone `runraid` and `incus-unraid` repos were merged in here. Some
  8. > deployed plugin install/update URLs still depend on the old-name redirect;
  9. > migrating those runtime URLs requires a deliberate release. The **PyPI package, the container image, the Claude plugin, and the
  10. > Unraid `.plg`** are all still named `unraid-mcp` — only the repo changed.
  11. ## Components
  12. | Path | What it is | Toolchain | Build / test |
  13. |------|-----------|-----------|--------------|
  14. | [`unraid-py/`](unraid-py/) | **unraid-mcp** — Python MCP server (GraphQL), the flagship. Published to PyPI as `unraid-mcp`. | Python / uv / hatchling | `cd unraid-py && uv run pytest && uv build --wheel` |
  15. | [`unraid-rs/`](unraid-rs/) | **runraid** — Rust MCP server + CLI (single static binary). Crate `unraid-rmcp` on crates.io, plus the compatibility npm launcher `@dinglebear/unraid`. | Rust / cargo | `cd unraid-rs && cargo fmt --check && cargo clippy --all-targets --features test-support -- -D warnings && cargo test` |
  16. | [`plugins/mcp/`](plugins/mcp/) | Unraid OS plugin that ships the Rust `runraid` MCP server onto an Unraid box. | shell `.plg` + Rust + Vue | `bash plugins/mcp/scripts/build-txz.sh <ver> <runraid-binary>` |
  17. | [`plugins/incus/`](plugins/incus/) | Unraid OS plugin running Incus system containers ("dev containers") firewalled off the LAN. Includes a NestJS/GraphQL `unraid-api` backend. | shell `.plg` + NestJS/Vue | `cd plugins/incus && ./scripts/verify-classic-package.sh && ./tests/classic-contract.sh` |
  18. | [`plugins/codex/`](plugins/codex/) | Unraid OS plugin embedding a Codex chathead app-server. | shell `.plg` + React | `cd plugins/codex && ./tests/contract.sh` |
  19. | [`agents/unraid-py/`](agents/unraid-py/) | Claude Code / Codex plugin (`name: unraid-mcp`) for the Python server. | — | — |
  20. | [`agents/unraid-rs/`](agents/unraid-rs/) | Claude Code / Codex plugin (`name: runraid`) for the Rust server. | — | — |
  21. ## Install the agent plugins (one marketplace command, two manifests)
  22. ```text
  23. /plugin marketplace add dinglebear-ai/unraid
  24. /plugin install unraid-mcp@unraid-mcp # Python server
  25. /plugin install runraid@unraid-mcp # Rust server
  26. ```
  27. The `@unraid-mcp` suffix is the **marketplace name** declared in
  28. `.claude-plugin/marketplace.json`, not the repo name — it stays `unraid-mcp` even
  29. though the repo is now `dinglebear-ai/unraid`.
  30. Both plugins are published from a single repo. Claude reads
  31. `.claude-plugin/marketplace.json`; Codex reads `.agents/plugins/marketplace.json`.
  32. `meta-ci.yml` asserts the two list the same plugin set, so they cannot drift.
  33. `marketplace add` accepts the `owner/repo` shorthand (or a full git URL / local
  34. path). After install, Claude Code prompts for the connection settings (the
  35. plugin's `userConfig`).
  36. ### Plugin credentials need no manual step
  37. The agent plugins ship **no Claude Code hooks**, and none are needed: both
  38. `.mcp.json` files map your plugin settings into the server environment directly
  39. via `${user_config.*}`. `agents/unraid-rs` wires endpoint, TLS, authentication, and tool-selector settings; `agents/unraid-py` wires `UNRAID_API_URL`
  40. and `UNRAID_API_KEY`. Set them in plugin settings and the server picks them up on
  41. next launch.
  42. Optional, for **non-plugin** installs (systemd, Docker) that want `~/.unraid/.env`
  43. written to disk:
  44. ```bash
  45. runraid setup plugin-hook # or: npx -y @dinglebear/unraid setup plugin-hook
  46. ```
  47. ## unraid-py quickstart (Python MCP server)
  48. The Python server is the flagship. Full documentation — installation, Claude
  49. Code / Codex / Gemini setup, configuration, authentication, guardrails, and the
  50. tool surface — lives in **[`unraid-py/README.md`](unraid-py/README.md)** and
  51. [`unraid-py/docs/`](unraid-py/docs/). It publishes to PyPI as `unraid-mcp` (import
  52. package `unraid_mcp`) and launches with `uvx unraid-mcp`.
  53. ## unraid-rs quickstart (Rust MCP server + CLI)
  54. ```bash
  55. cargo install --path unraid-rs --locked # from the repository root
  56. # Configure UNRAID_API_URL and UNRAID_API_KEY privately before querying.
  57. runraid setup check # inspect setup without repairing files
  58. runraid array # read array state
  59. runraid serve mcp # MCP HTTP (default :40010; configure auth)
  60. ```
  61. | Env var | Purpose |
  62. |---|---|
  63. | `UNRAID_API_URL` | Unraid GraphQL endpoint (required) |
  64. | `UNRAID_API_KEY` | `x-api-key` for the Unraid API (required) |
  65. | `UNRAID_API_SKIP_TLS_VERIFY` | Accept a self-signed Unraid cert (default `false`) |
  66. | `UNRAID_RMCP_HOST` / `UNRAID_RMCP_PORT` | MCP bind address (default `0.0.0.0:40010`) |
  67. | `UNRAID_RMCP_TOKEN` | Static bearer token for `/mcp` |
  68. | `UNRAID_RMCP_AUTH_MODE` | `bearer` (default) or `oauth` |
  69. Full list and the OAuth variables: [`unraid-rs/AGENTS.md`](unraid-rs/AGENTS.md).
  70. **Not read-only.** The Rust server exposes both queries and mutations. Read actions
  71. need the `unraid:read` scope; mutating actions (VM and Docker lifecycle, array
  72. start/stop, notification writes) need `unraid:admin`.
  73. ## Development and documentation
  74. Start with [AGENTS.md](AGENTS.md), the canonical contributor guide.
  75. `CLAUDE.md` and `GEMINI.md` are symlinks to it, including within components.
  76. The [documentation index](docs/README.md) links to
  77. [development and verification](docs/DEVELOPMENT.md),
  78. [architecture](docs/ARCHITECTURE.md), and [release procedures](docs/RELEASING.md).
  79. Rust MCP supports `UNRAID_RMCP_PROJECTION=legacy` (default), `atomic`, or `both`.
  80. All projections share enabled-action policy, scopes, and execution; atomic mode
  81. is not a second backend. See the Rust README for selectors and migration.
  82. ## Releases
  83. There are two release lanes. **release-please manages only `unraid-py` and
  84. `unraid-rs`** — the Python server keeps unprefixed `vX.Y.Z` tags (the existing
  85. audience's scheme) and Rust uses `unraid-rs-vX.Y.Z`. The **Incus and Codex plugins
  86. do not use release-please**: they are versioned by
  87. `.github/scripts/plugin_calver.py` with fixed-width `YYYYMMDD.NNN` versions and
  88. `incus-v*` / `codex-v*` tags (Unraid compares plugin versions as raw strings, so the
  89. fixed width is mandatory).
  90. The native MCP plugin is built from the matching `unraid-rs-vX.Y.Z` tag, and Community Applications reads its rolling manifest from the `unraid-plugin-latest` release. Plugin `.txz` payloads ship as GitHub **release assets**, never tracked in git.
  91. ## License
  92. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.