Unraid MCP
MCP server for Unraid API — provides tools to interact with an Unraid server's GraphQL API.
tv.tootie/unraid-mcp · Repository · version 2.8.0 · 126 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-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
Installed 72 packages in 22ms
[08/16/26 02:50:35] 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/qfbaLTnmfEIswkEg/
lib/python3.13/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.8.0 │
│ 🚀 Deploy free: https://horizon.prefect.io │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
[08/16/26 02:50:35] 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 [10630]
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-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
Installed 70 packages in 336ms
[08/16/26 02:55:10] 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 /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/d5rIDkkal91TGIOE
/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.8.0 │
│ 🚀 Deploy free: https://horizon.prefect.io │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
[08/16/26 02:55:11] 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 [42227]
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-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
Installed 72 packages in 28.94s
[08/16/26 04:47:57] INFO [SUBSCRIPTION_MANAGER] Initialized with
auto_start=True, max_reconnects=10
[08/16/26 04:47:58] 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 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\yV4Fl50I_giCtBkb\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.8.0 |
| \U0001f680 Deploy free: https://horizon.prefect.io |
| |
+-----------------------------------------------------------------------------+
[08/16/26 04:47:58] 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 [2124]
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/tv.tootie__unraid-mcp.html)