How do I install Unraid?

Unraid is a local plugin. Install it using PyPI package: unraid-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Unraid safe to use?

Unraid was flagged by MCP Marketplace's security scan, scoring 0/10 (critical risk). It has 13 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Unraid need?

Unraid requires the following credentials or environment variables: UNRAID_API_URL, UNRAID_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Unraid?

Unraid uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Unraid MCP Server

by Jmagar

Developer ToolsUse Caution0.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP server for Unraid API — provides tools to interact with an Unraid server's GraphQL API.

About

MCP server for Unraid API — provides tools to interact with an Unraid server's GraphQL API.

Security Report

0.0

Use Caution0.0Critical Risk

This MCP server contains critical security vulnerabilities. The codebase includes obfuscated WebAssembly binary data embedded directly in source files, a pattern commonly associated with malware distribution. Additionally, there are dangerous patterns including unsanitized subprocess calls in test files, environment variable exfiltration risks, and extensive use of eval-like operations on untrusted GraphQL subscriptions. The embedded binary and obfuscation patterns represent a severe red flag. Supply chain analysis found 12 known vulnerabilities in dependencies (0 critical, 7 high severity). Package verification found 1 issue.

4 files analyzed · 24 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Base URL of your Unraid server, e.g. http://192.168.1.100.Optional

Environment variable: UNRAID_API_URL

Unraid API key for authentication.Required

Environment variable: UNRAID_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "tv-tootie-unraid-mcp": {
      "env": {
        "UNRAID_API_KEY": "your-unraid-api-key-here",
        "UNRAID_API_URL": "your-unraid-api-url-here"
      },
      "args": [
        "-y",
        "unraid-codex-chathead"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Unraid

A monorepo of Unraid tooling: two MCP servers (Python and Rust) and three Unraid OS plugins, plus the Claude/Codex agent integrations that surface them.

Components

Path	What it is	Toolchain	Build / test
`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`
`unraid-rs/`	runraid — Rust MCP server + CLI (single static binary), `unraid-rmcp` on npm.	Rust / cargo	`cd unraid-rs && cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test`
`plugins/mcp/`	Unraid OS plugin that ships the Python MCP server onto an Unraid box.	shell `.plg` + Python	`bash plugins/mcp/scripts/build-txz.sh <ver> <wheel>`
`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`
`plugins/codex/`	Unraid OS plugin embedding a Codex chathead app-server.	shell `.plg` + React	`cd plugins/codex && ./tests/contract.sh`
`agents/unraid-py/`	Claude Code / Codex plugin (`name: unraid-mcp`) for the Python server.	—	—
`agents/unraid-rs/`	Claude Code / Codex plugin (`name: runraid`) for the Rust server.	—	—

Install the agent plugins (one marketplace command, two manifests)

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

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) and persists them to ~/.unraid-mcp/.env.

unraid-py quickstart (Python MCP server)

The Python server is the flagship. Full documentation — installation, Claude Code / Codex / Gemini setup, configuration, authentication, guardrails, and the tool surface — lives in unraid-py/README.md and unraid-py/docs/. It publishes to PyPI as unraid-mcp (import package unraid_mcp) and launches with uvx unraid-mcp.

Releases

Versioning is driven by release-please across all four release units. The Python server keeps unprefixed vX.Y.Z tags (the existing audience's scheme); the other components use prefixed tags: unraid-rs-vX.Y.Z, incus-vX.Y.Z, codex-vX.Y.Z. Plugin .txz payloads ship as GitHub release assets, not tracked in git.

License

MIT — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Unraid MCP Server

About

Security Report

Findings (24)Action required

Permissions Required

What You'll Need

How to Install

Documentation

Unraid

Components

Install the agent plugins (one marketplace command, two manifests)

unraid-py quickstart (Python MCP server)

Releases

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace