# Unraid MCP

> Unraid MCP is an open-source MCP server for cloud and infrastructure. Query and manage an Unraid server's GraphQL API, with Python and Rust servers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux
- **Repository:** https://github.com/dinglebear-ai/unraid
- **MCP Registry name:** ai.dinglebear/unraid-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Behind this registry entry sits a monorepo, and the Python package `unraid-mcp` (version 2.10.3 on PyPI) is its flagship. It talks to the GraphQL API of an Unraid box and needs two settings, `UNRAID_API_URL` for the server's base URL and `UNRAID_API_KEY` for authentication. It launches with `uvx unraid-mcp`.

The repository also ships a second server written in Rust, called runraid, as a single static binary and CLI. The README says the Rust server exposes both queries and mutations: read actions need an `unraid:read` scope, while VM and Docker lifecycle, array start and stop, and notification writes need `unraid:admin`. It can be bound with a static bearer token or OAuth, and can accept a self-signed Unraid certificate when told to.

Extras include Claude Code and Codex plugins for each server and three Unraid OS plugins that install the server, run Incus containers, or embed a Codex app-server. The repo was renamed from `unraid-mcp` to `unraid` in July 2026, and the licence is MIT.

## Features

- **GraphQL access:** Reads state from an Unraid server through its GraphQL API.
- **Python and Rust servers:** Offers a Python server and a single-binary Rust server with a CLI.
- **Scoped permissions:** The Rust server separates read from admin actions such as VM and Docker lifecycle.
- **Agent plugins:** Includes Claude Code and Codex plugins that map settings into the server environment.
- **Unraid OS plugin:** Packages the Rust server as a plugin for the Unraid box itself.

## Good for

- Ask an assistant for the current array state
- Start or stop VMs and Docker containers from chat
- Check notifications on a home server
- Run the MCP server on the Unraid box as a native plugin

## Install

### Claude Code (Terminal)

```sh
claude mcp add unraid-mcp --env UNRAID_API_URL='<UNRAID_API_URL>' --env UNRAID_API_KEY='<UNRAID_API_KEY>' -- uvx unraid-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unraid-mcp": {
      "command": "uvx",
      "args": [
        "unraid-mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unraid-mcp": {
      "command": "uvx",
      "args": [
        "unraid-mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unraid-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unraid-mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unraid-mcp": {
      "command": "uvx",
      "args": [
        "unraid-mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unraid-mcp": {
      "command": "uvx",
      "args": [
        "unraid-mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<UNRAID_API_URL>",
        "UNRAID_API_KEY": "<UNRAID_API_KEY>"
      }
    }
  }
}
```

## FAQ

### What does it need to connect?

An Unraid API URL and an API key, set as UNRAID_API_URL and UNRAID_API_KEY.

### Can it change things on the server?

Yes. The Rust server exposes mutations, which need the unraid:admin scope; read actions need unraid:read.

### What is the licence?

MIT.

### Is the repo name the same as the package?

No. The repo was renamed to unraid on 2026-07-27, but the PyPI package, container image and plugin keep the name unraid-mcp.

### Is Unraid MCP free?

Yes. Unraid MCP is open source, so you can use and self-host it for free.

### How do I add Unraid MCP to Claude Code?

Run this command in your terminal: claude mcp add unraid-mcp --env UNRAID_API_URL='<UNRAID_API_URL>' --env UNRAID_API_KEY='<UNRAID_API_KEY>' -- uvx unraid-mcp

### What are the best alternatives to Unraid MCP?

The closest alternatives to Unraid MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/unraid-mcp-2
