Skip to content
MCP server

Unraid MCP

Query and manage an Unraid server's GraphQL API, with Python and Rust servers

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
2.10.3
Listing updated
today

Similar MCP servers

About Unraid MCP

Unraid MCP is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • UNRAID_API_URLBase URL of your Unraid server, e.g. http://192.168.1.100.Required
  • UNRAID_API_KEYUnraid API key for authentication.Required

What it does

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

Pricing

Open source

MIT licence

Unraid MCP 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.

How AIPoweredBot checks servers