How do I install TrueNAS SCALE?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does TrueNAS SCALE need an API key?

The publisher lists these environment variables: TRUENAS_MCP_TARGET, TRUENAS_MCP_ALLOW_PLAINTEXT, TRUENAS_MCP_TARGET_INSECURE, TRUENAS_MCP_ENABLE_WRITES.

What transport does TrueNAS SCALE use?

TrueNAS SCALE runs locally over stdio.

When was TrueNAS SCALE last checked?

Last checked 2026-11-09. Inspect and manage TrueNAS SCALE storage, shares, apps and system state with your own API key

TrueNAS SCALE MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

docker run -i --rm ghcr.io/cedricziel/truenas-mcp:0.4.2

Credentials from the publisher

TRUENAS_MCP_TARGET — TrueNAS host to manage, optionally `host:port`. Requires TrueNAS SCALE 25.04 or later.
TRUENAS_MCP_ALLOW_PLAINTEXT — 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 — 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 — Expose the mutating tools. Read-only by default; unrecoverable operations stay unreachable either way.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TRUENAS_MCP_TARGET=<value> TRUENAS_MCP_ALLOW_PLAINTEXT=<value> TRUENAS_MCP_TARGET_INSECURE=<value> TRUENAS_MCP_ENABLE_WRITES=<value> claude mcp add io.github.cedricziel-truenas-mcp -- docker run -i --rm ghcr.io/cedricziel/truenas-mcp:0.4.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.cedricziel-truenas-mcp": {4      "command": "docker",5      "args": [6        "run",7        "-i",8        "--rm",9        "ghcr.io/cedricziel/truenas-mcp:0.4.2"10      ],11      "env": {12        "TRUENAS_MCP_TARGET": "<value>",13        "TRUENAS_MCP_ALLOW_PLAINTEXT": "<value>",14        "TRUENAS_MCP_TARGET_INSECURE": "<value>",15        "TRUENAS_MCP_ENABLE_WRITES": "<value>"16      }17    }18  }19}

claude_desktop_config.json

Local · ociPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

TrueNAS SCALE

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install TrueNAS SCALE?

Does TrueNAS SCALE need an API key?

What transport does TrueNAS SCALE use?

When was TrueNAS SCALE last checked?

Documentation