Unraid MCP
Query and manage an Unraid server's GraphQL API, with Python and Rust servers
- 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-mcpAdd 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.RequiredUNRAID_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.


