# UnraidClaw

UnraidClaw is a permission-enforcing Representational State Transfer (REST) application programming interface (API) and Model Context Protocol (MCP) server that lets artificial intelligence (AI) agents manage Unraid. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4109/unraidclaw

## Description

UnraidClaw is a permission-enforcing Representational State Transfer (REST) application programming interface (API) and Model Context Protocol (MCP) server that lets artificial intelligence (AI) agents manage Unraid servers. It combines Unraid's GraphQL API with direct system integration for Docker, virtual machines (VMs), the storage array, shares, system tasks, notifications, network settings, and logs. It provides 43 tools across 11 categories, a resource:action permission matrix configurable from the Unraid web interface, HTTPS with an auto-generated Transport Layer Security (TLS) certificate, SHA-256 API-key authentication, and filterable activity logging. It also provides an OpenClaw plugin for OpenClaw assistants. It is for self-hosters who want AI assistants to operate Unraid with controlled access and an audit trail. It requires Unraid 7.0.0 or later, which includes Node.js 22+.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

64/100 (Good), based on 4 of 5 factors.
- Maintained: 91 (last commit 10 days ago)
- Popular: 34 (50 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/unraidclaw-0wkdvws0brudhk?q=UnraidClaw
- GitHub: https://github.com/emaspa/unraidclaw

## Common questions

### How do I enable UnraidClaw after installing the plugin?

Copy your Unraid API key with the ADMIN role from Settings > Management Access, paste it into Settings > UnraidClaw, generate an UnraidClaw API key, configure the Permissions tab, then set Service to Enabled and click Apply.

### Which port does UnraidClaw use and is it encrypted?

It listens on port 9876 over HTTPS by default. A self-signed TLS certificate is generated on first start.

### Is the MCP endpoint enabled by default?

No, the MCP endpoint is optional and off by default. It is served at /mcp and uses the same API key and permissions as the REST API.

### Where is the UnraidClaw service configuration stored?

Clicking Apply writes the configuration to /boot/config/plugins/unraidclaw/unraidclaw.cfg and restarts the service.

### Can I use a command-line client from another machine?

Yes, the CLI is built into the plugin and is also available for other machines from npm or as a release archive.

### What does UnraidClaw activity logging record?

It records activity in JSONL format with filter and search. The public health probe and successful MCP handshakes are excluded.

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