Unraid MCP server
{
"mcpServers": {
"dinglebear-unraid": {
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid@latest"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}{
"mcpServers": {
"dinglebear-unraid": {
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid@latest"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}{
"mcpServers": {
"dinglebear-unraid": {
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid@latest"
],
"env": {
"UNRAID_API_URL": "https://...",
"UNRAID_API_KEY": "<unraid_api_key>",
"UNRAID_RMCP_TOKEN": "<unraid_rmcp_token>"
}
}
}
}{
"servers": {
"dinglebear-unraid": {
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid@latest"
],
"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": {
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid@latest"
],
"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 npx -y @dinglebear/unraidversion 0.3.0
What it does
MCP server for Unraid that provides GraphQL operations across NAS, Docker, VM, and storage workflows. Available in Python and Rust implementations, designed for developers integrating Unraid systems with Claude or other AI agents.
- Query and manage Unraid array status, Docker containers, and virtual machines through GraphQL mutations and queries.
- Automate VM and Docker lifecycle operations (start, stop) and array management via MCP tools.
- Integrate Unraid operations into Claude Code or Codex agent workflows using the agent plugins.
Tools this server exposes
| Tool | Does |
|---|---|
| array | Query Unraid array status and configuration. |
| docker | Manage Docker containers on Unraid. |
| vm | Manage virtual machines on Unraid. |
| storage | Query and manage storage workflows. |
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.