M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
U

Unraid MCP

Community
Query, monitor, and manage Unraid servers via GraphQL
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #280 of 438
Stars
★ 137 Very popular
Transport
stdio (local process)
Runtime
Python
Credentials
API key / credential required
License
MIT
Last commit
Tools
1
48FMRS · D

Community-maintained MCP server for managing Unraid, offering a rich toolset, but requiring attention to permissions and risks.

Strongest · Maintenance 11/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
10/20
Maintenance
11/20
Documentation
9/20
Setup experience
10/20
Why each score
Reliability 8/20
The manifest is well-formed and lists a clear uvx launch path and two required environment variables. The README claims pytest and CI tests, but no actual source, test files, or workflow files are provided, so we cannot verify clean startup, the init/tool-list handshake, or that tools match real behavior. With 13 open issues and no verifiable execution evidence, a conservative score of 8 is appropriate.
Security and permissions 10/20
The API key is correctly marked as required and secret in the manifest, which is good practice. However, the server likely supports mutating actions, and the supplied materials do not document any confirmation mechanisms or least-privilege scoping for the Python server; the scope note in the README belongs to the Rust server. No red-line issues (malware, exfiltration, hardcoded secrets) are present, but the missing evidence on dangerous operations caps the score at 10.
Maintenance 11/20
The repository is not archived, has an MIT license, and the README mentions release-please managing versions and CI tests; version 2.10.1 suggests continuous releases. However, commit history, issue response times, and dependency update evidence are unavailable, and only 13 open issues are known. Under a conservative static review, this warrants a score of 11.
Documentation 9/20
The top-level README is fairly detailed about repository structure, releases, and plugin installation, but the full documentation for this Python server (tool parameters, troubleshooting, limitations, cost) is referenced to unraid-py/README.md and docs/, which are not included. Also, the README's mcp-name comment (tv.tootie/unraid-mcp) conflicts with the manifest name (ai.dinglebear/unraid-mcp), causing confusion. Thus the score is 9.
Setup experience 10/20
The uvx unraid-mcp launch path is straightforward, and the two required environment variables are clearly listed in the manifest. However, concrete configuration examples for mainstream clients (Claude, Codex, Gemini) are part of the unavailable documentation. Additionally, per the static calibration, setup cannot exceed 15 without verified CI/test evidence; balancing simplicity and missing details, we assign 10.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Unraid users who want to manage their homelab via AI assistants
  • Developers integrating Unraid into Claude Code, Codex, or other MCP clients

Not for

  • Users requiring official vendor support (community-maintained)
  • Users needing a graphical interface

Required permissions

  • Requires UNRAID_API_URL (required)
  • Requires UNRAID_API_KEY (required, secret)

Risks and side effects

  • Exposes API key; potential unauthorized access if leaked
  • Some actions (like array start/stop) can affect data availability

Setup

Before you start

Runtime：Python

UNRAID_API_URL required Base URL of your Unraid server, e.g. http://192.168.1.100; comes from your own server, required.
UNRAID_API_KEY requiredsecret Unraid API key for authentication with the GraphQL API; generate it on your Unraid server, required and secret.

Run with uvx: uvx unraid-mcp, set environment variables UNRAID_API_URL and UNRAID_API_KEY.

Check that it works

The unraid_query tool should appear in your client's tool list; asking for system info and receiving real Unraid host data confirms the connection.

Troubleshooting

  1. Verify UNRAID_API_URL is correct (e.g., http://192.168.1.100)
  2. Confirm UNRAID_API_KEY is valid
  3. Ensure the Unraid server is reachable from the MCP host
  4. If using a self-signed certificate, you may need to skip TLS verification (not explicitly documented for Python version)

Things to try

Once connected, you can ask your AI assistant things like:

  • Show me system info and live telemetry for my Unraid server
  • List all Docker containers running on my Unraid server and their status
  • Check the array status and parity progress
  • Query unread notifications and the list of installed plugins

Tools 1

unraid_query read-only
A generic tool to query Unraid server status and perform management actions

Use cases

Monitor Unraid system health (array, disks, CPU)
Manage Docker containers and virtual machines
View and send notifications

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

Unraid MCP server (unraid-mcp) provides tools to interact with an Unraid server's GraphQL API, enabling system info, Docker containers, VMs, array/parity, notifications, plugins, rclone, and live telemetry.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →
Compare with other MCP servers

More servers from this repository

Unraid

Source revision 6d00e73cd7dd Data synced 2026-10-12 Read the FMRS scoring method