# Unraid-MCP

Unraid-MCP is a self-hosted ai app. MCP server that lets MCP clients query and manage your Unraid server through the Unraid GraphQL API: system info, array and parity, disks, shares, Docker, VMs, notifications, plugins, rclone and live telemetry. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7243/unraid-mcp

## Description

MCP server that lets MCP clients query and manage your Unraid server through the Unraid GraphQL API: system info, array and parity, disks, shares, Docker, VMs, notifications, plugins, rclone and live telemetry. Destructive actions require an explicit confirmation. First launch: 1. In Unraid, open Settings › Management Access › API Keys, create a key and paste it in Unraid API key. 2. Set Unraid API URL to the GraphQL endpoint of the server, e.g. http://192.168.1.10/graphql. 3. Generate a token (openssl rand -hex 32 in the Unraid terminal) and paste it in MCP bearer token. 4. In your MCP client, add the streamable HTTP server http://Unraid-IP:6970/mcp with the header Authorization: Bearer YOUR_TOKEN. The server has no web page. It can stop the array, containers and VMs: never expose its port to the internet.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

64/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 43 (143 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_63623b7f8a0b22db
- GitHub: https://github.com/dinglebear-ai/unraid

## Common questions

### Can Unraid-MCP make server changes without confirmation?

No. The monitoring tools are always on, and anything that can change the server is opt-in and asks for confirmation.

### Which Unraid interface does the MCP server use?

It connects the Unraid box to MCP-aware agents through Unraid's official GraphQL API.

### How do I install the Unraid-MCP agent plugin for Claude Code or Codex?

Add the Unraid repository marketplace, then install unraid-mcp@unraid-mcp for the Python server or runraid@unraid-mcp for the Rust server.

### Do package and plugin names change after the repository rename?

The repo was renamed from unraid-mcp to unraid, but the PyPI package, container image, Claude plugin, and Unraid .plg files are still named unraid-mcp. Some deployed plugin install and update URLs still depend on the old-name redirect.

---
Source: Our Local Host (https://ourlocalhost.com/app/7243/unraid-mcp), the self-hosted and open-source app directory.