Skip to content
MCP server

TrueNAS SCALE

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

Install
Pricing
Open source
Runs
Remotely
Version
0.4.2
Listing updated
5 days ago

About TrueNAS SCALE

TrueNAS SCALE is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

claude mcp add truenas-mcp --env TRUENAS_MCP_TARGET='<TRUENAS_MCP_TARGET>' -- docker run -i --rm -e TRUENAS_MCP_TARGET ghcr.io/cedricziel/truenas-mcp:0.4.2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "truenas-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRUENAS_MCP_TARGET",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "truenas-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRUENAS_MCP_TARGET",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "truenas-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRUENAS_MCP_TARGET",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "truenas-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRUENAS_MCP_TARGET",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "truenas-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRUENAS_MCP_TARGET",
        "ghcr.io/cedricziel/truenas-mcp:0.4.2"
      ],
      "env": {
        "TRUENAS_MCP_TARGET": "<TRUENAS_MCP_TARGET>"
      }
    }
  }
}

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

Configuration

  • TRUENAS_MCP_TARGETTrueNAS host to manage, optionally `host:port`. Requires TrueNAS SCALE 25.04 or later.Required
  • TRUENAS_MCP_ALLOW_PLAINTEXTServe 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_INSECUREAccept 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_WRITESExpose the mutating tools. Read-only by default; unrecoverable operations stay unreachable either way.

Pricing

Open source

TrueNAS SCALE FAQ

Is TrueNAS SCALE free?

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

How do I add TrueNAS SCALE to Claude Code?

Run this command in your terminal: claude mcp add truenas-mcp --env TRUENAS_MCP_TARGET='<TRUENAS_MCP_TARGET>' -- docker run -i --rm -e TRUENAS_MCP_TARGET ghcr.io/cedricziel/truenas-mcp:0.4.2

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers