Unraid MCP server
{
"mcpServers": {
"dinglebear-unraid-mcp": {
"command": "uvx",
"args": [
"unraid-mcp"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}{
"mcpServers": {
"dinglebear-unraid-mcp": {
"command": "uvx",
"args": [
"unraid-mcp"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}{
"mcpServers": {
"dinglebear-unraid-mcp": {
"command": "uvx",
"args": [
"unraid-mcp"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}{
"servers": {
"dinglebear-unraid-mcp": {
"command": "uvx",
"args": [
"unraid-mcp"
],
"env": {
"UNRAID_API_URL": "${input:unraid_api_url}",
"UNRAID_API_KEY": "${input:unraid_api_key}",
"UNRAID_RMCP_TOKEN": "${input:unraid_rmcp_token}"
}
}
},
"inputs": [
{
"id": "unraid_api_url",
"type": "promptString",
"description": "Unraid api url",
"password": true
},
{
"id": "unraid_api_key",
"type": "promptString",
"description": "Unraid api key",
"password": true
},
{
"id": "unraid_rmcp_token",
"type": "promptString",
"description": "Unraid rmcp token",
"password": true
}
]
}{
"mcpServers": {
"dinglebear-unraid-mcp": {
"command": "uvx",
"args": [
"unraid-mcp"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall uvx unraid-mcpversion 2.10.1
What it does
MCP server for interacting with an Unraid server via its GraphQL API. Provides tools to query and manage Unraid system state, including VMs, Docker containers, and array operations. Built in Python (flagship) and Rust, for developers who want to automate Unraid administration through Claude or other AI agents.
- Query Unraid array status, VM and Docker container state, and system information via GraphQL
- Perform administrative actions like starting/stopping the array, managing VM and Docker container lifecycles, and writing notifications
- Integrate Unraid management into Claude Code or Codex agents with OAuth or bearer token authentication
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.