Unraid MCP
MCP server for Unraid API — provides tools to interact with an Unraid server's GraphQL API.
ai.dinglebear/unraid-mcp · Repository · version 2.10.1 · 131 stars · listed from registry
Install
The sweep installs into a clean prefix, but this is the command a user would run:
uvx unraid-mcpNeeds credentials: UNRAID_API_URL, UNRAID_API_KEY. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.
Results by platform
Linux
timed out2026-09-28 · probed over pypi14 recorded runs, oldest first.
handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
…loop
Downloaded cryptography
Installed 72 packages in 70ms
[09/28/26 09:26:37] INFO [SUBSCRIPTION_MANAGER] Initialized with
auto_start=True, max_reconnects=10
INFO Subscription resources registered successfully
INFO Subscription resources registered
INFO Unraid tool registered successfully
INFO unraid tool registered successfully - Server ready!
[unraid-mcp] Generated HTTP bearer token and saved it to /home/runner/.unraid-mcp/.env.
Configure your MCP client to send Authorization: Bearer <token> using that stored value.
INFO Bearer token generated and written to
/home/runner/.unraid-mcp/.env
INFO Logging initialized (console and file:
/home/runner/.cache/uv/archive-v0/9WKciAskIANSyYqG/
lib/python3.12/logs/unraid-mcp.log).
INFO UNRAID_API_URL loaded: ://unknown
INFO UNRAID_API_KEY loaded: ****
INFO UNRAID_MCP_PORT set to: 6970
INFO UNRAID_MCP_HOST set to: 127.0.0.1
INFO UNRAID_MCP_TRANSPORT set to: streamable-http
INFO UNRAID_MCP_LOG_LEVEL set to: INFO
INFO HTTP bearer token authentication enabled.
INFO Starting Unraid MCP Server on 127.0.0.1:6970 using
streamable-http transport...
╭──────────────────────────────────────────────────────────────────────────────╮
│ │
│ │
│ ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█ │
│ █▀ █▀█ ▄▄█ █ █ ▀ █ █▄▄ █▀▀ │
│ │
│ │
│ │
│ FastMCP 3.4.7 │
│ https://gofastmcp.com │
│ │
│ 🖥 Server: Unraid MCP Server, 2.10.1 │
│ 🚀 Deploy free: https://horizon.prefect.io │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────────────────────────╮
│ 🎉 Update available: 4.0.10 │
│ Run: pip install --upgrade fastmcp │
╰──────────────────────────────────────────────────────────────────────────────╯
[09/28/26 09:26:38] INFO Starting MCP server 'Unraid MCP transport.py:361
Server' with transport
'streamable-http' on
http://127.0.0.1:6970/mcp
INFO: Started server process [2390]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:6970 (Press CTRL+C to quit)
macOS
timed out2026-09-28 · probed over pypi14 recorded runs, oldest first.
handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
…ts
Downloaded cryptography
Installed 70 packages in 112ms
[09/28/26 09:26:56] INFO [SUBSCRIPTION_MANAGER] Initialized with
auto_start=True, max_reconnects=10
INFO Subscription resources registered successfully
INFO Subscription resources registered
[09/28/26 09:26:57] INFO Unraid tool registered successfully
INFO unraid tool registered successfully - Server ready!
[unraid-mcp] Generated HTTP bearer token and saved it to /Users/runner/.unraid-mcp/.env.
Configure your MCP client to send Authorization: Bearer <token> using that stored value.
INFO Bearer token generated and written to
/Users/runner/.unraid-mcp/.env
INFO Logging initialized (console and file:
/Users/runner/.cache/uv/archive-v0/mO6cT-nFVWyD0K_k
/lib/python3.14/logs/unraid-mcp.log).
INFO UNRAID_API_URL loaded: ://unknown
INFO UNRAID_API_KEY loaded: ****
INFO UNRAID_MCP_PORT set to: 6970
INFO UNRAID_MCP_HOST set to: 127.0.0.1
INFO UNRAID_MCP_TRANSPORT set to: streamable-http
INFO UNRAID_MCP_LOG_LEVEL set to: INFO
INFO HTTP bearer token authentication enabled.
INFO Starting Unraid MCP Server on 127.0.0.1:6970 using
streamable-http transport...
╭──────────────────────────────────────────────────────────────────────────────╮
│ │
│ │
│ ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█ │
│ █▀ █▀█ ▄▄█ █ █ ▀ █ █▄▄ █▀▀ │
│ │
│ │
│ │
│ FastMCP 3.4.7 │
│ https://gofastmcp.com │
│ │
│ 🖥 Server: Unraid MCP Server, 2.10.1 │
│ 🚀 Deploy free: https://horizon.prefect.io │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────────────────────────╮
│ 🎉 Update available: 4.0.10 │
│ Run: pip install --upgrade fastmcp │
╰──────────────────────────────────────────────────────────────────────────────╯
[09/28/26 09:26:57] INFO Starting MCP server 'Unraid MCP transport.py:361
Server' with transport
'streamable-http' on
http://127.0.0.1:6970/mcp
INFO: Started server process [1656]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:6970 (Press CTRL+C to quit)
Windows
timed out2026-09-28 · probed over pypi14 recorded runs, oldest first.
handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
… Subscription resources registered
INFO Unraid tool registered successfully
INFO unraid tool registered successfully - Server
ready!
[unraid-mcp] Generated HTTP bearer token and saved it to C:\Users\runneradmin\.unraid-mcp\.env.
Configure your MCP client to send Authorization: Bearer <token> using that stored value.
INFO Bearer token generated and written to
C:\Users\runneradmin\.unraid-mcp\.env
INFO Logging initialized (console and file:
C:\Users\runneradmin\AppData\Local\uv\cache\archiv
e-v0\4zupiAy5KJ-4-K_2\Lib\logs\unraid-mcp.log).
INFO UNRAID_API_URL loaded: ://unknown
INFO UNRAID_API_KEY loaded: ****
INFO UNRAID_MCP_PORT set to: 6970
INFO UNRAID_MCP_HOST set to: 127.0.0.1
INFO UNRAID_MCP_TRANSPORT set to: streamable-http
INFO UNRAID_MCP_LOG_LEVEL set to: INFO
INFO HTTP bearer token authentication enabled.
INFO Starting Unraid MCP Server on 127.0.0.1:6970 using
streamable-http transport...
+-----------------------------------------------------------------------------+
| |
| |
| \u2584\u2580\u2580 \u2584\u2580\u2588 \u2588\u2580\u2580 \u2580\u2588\u2580 \u2588\u2580\u2584\u2580\u2588 \u2588\u2580\u2580 \u2588\u2580\u2588 |
| \u2588\u2580 \u2588\u2580\u2588 \u2584\u2584\u2588 \u2588 \u2588 \u2580 \u2588 \u2588\u2584\u2584 \u2588\u2580\u2580 |
| |
| |
| |
| FastMCP 3.4.7 |
| https://gofastmcp.com |
| |
| \U0001f5a5 Server: Unraid MCP Server, 2.10.1 |
| \U0001f680 Deploy free: https://horizon.prefect.io |
| |
+-----------------------------------------------------------------------------+
+-----------------------------------------------------------------------------+
| \U0001f389 Update available: 4.0.10 |
| Run: pip install --upgrade fastmcp |
+-----------------------------------------------------------------------------+
[09/28/26 09:30:40] INFO Starting MCP server 'Unraid MCP transport.py:361
Server' with transport
'streamable-http' on
http://127.0.0.1:6970/mcp
INFO: Started server process [6516]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:6970 (Press CTRL+C to quit)
Badge
Paste this into the project README to show the current result:
[](https://doesitinstall.com/s/ai.dinglebear__unraid-mcp.html)