NestDaddy

TrueNAS SCALE

io.github.cedricziel/truenas-mcp · v0.4.2

Inspect and manage TrueNAS SCALE storage, shares, apps and system state with your own API key

Connect Runs on your machine

Terminal
claude mcp add truenas-mcp -e TRUENAS_MCP_TARGET=<TRUENAS_MCP_TARGET> -e TRUENAS_MCP_ALLOW_PLAINTEXT=<TRUENAS_MCP_ALLOW_PLAINTEXT> -e TRUENAS_MCP_TARGET_INSECURE=<TRUENAS_MCP_TARGET_INSECURE> -e TRUENAS_MCP_ENABLE_WRITES=<TRUENAS_MCP_ENABLE_WRITES> -- docker run -i --rm ghcr.io/cedricziel/truenas-mcp:0.4.2
claude_desktop_config.json
{
  "mcpServers": {
    "truenas-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>",
        "TRUENAS_MCP_ALLOW_PLAINTEXT": "<TRUENAS_MCP_ALLOW_PLAINTEXT>",
        "TRUENAS_MCP_TARGET_INSECURE": "<TRUENAS_MCP_TARGET_INSECURE>",
        "TRUENAS_MCP_ENABLE_WRITES": "<TRUENAS_MCP_ENABLE_WRITES>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "truenas-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>",
        "TRUENAS_MCP_ALLOW_PLAINTEXT": "<TRUENAS_MCP_ALLOW_PLAINTEXT>",
        "TRUENAS_MCP_TARGET_INSECURE": "<TRUENAS_MCP_TARGET_INSECURE>",
        "TRUENAS_MCP_ENABLE_WRITES": "<TRUENAS_MCP_ENABLE_WRITES>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "truenas-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>",
        "TRUENAS_MCP_ALLOW_PLAINTEXT": "<TRUENAS_MCP_ALLOW_PLAINTEXT>",
        "TRUENAS_MCP_TARGET_INSECURE": "<TRUENAS_MCP_TARGET_INSECURE>",
        "TRUENAS_MCP_ENABLE_WRITES": "<TRUENAS_MCP_ENABLE_WRITES>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
TRUENAS_MCP_TARGET
Required
TrueNAS host to manage, optionally `host:port`. Requires TrueNAS SCALE 25.04 or later.
TRUENAS_MCP_ALLOW_PLAINTEXT
Optional
Serve MCP without TLS. Set here because the listener is published on loopback only; drop it and supply TRUENAS_MCP_TLS_CERT/KEY if the port is reachable from elsewhere.
TRUENAS_MCP_TARGET_INSECURE
Optional
Accept the TrueNAS certificate unverified while keeping the connection encrypted. TrueNAS ships a self-signed certificate for `CN=localhost`, so no address you can reach it by will validate.
TRUENAS_MCP_ENABLE_WRITES
Optional
Expose the mutating tools. Read-only by default; unrecoverable operations stay unreachable either way.

Details

Packageghcr.io/cedricziel/truenas-mcp:0.4.2 (OCI, streamable-http)
First published11 Aug 2026
Last updated11 Aug 2026
Registry nameio.github.cedricziel/truenas-mcp

More files and documents servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.