Inspect and manage TrueNAS SCALE storage, shares, apps and system state with your own API key
Connect Runs on your machine
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
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
TRUENAS_MCP_TARGETRequired | TrueNAS host to manage, optionally `host:port`. Requires TrueNAS SCALE 25.04 or later. |
TRUENAS_MCP_ALLOW_PLAINTEXTOptional | 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_INSECUREOptional | 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_WRITESOptional | Expose the mutating tools. Read-only by default; unrecoverable operations stay unreachable either way. |
Details
| Package | ghcr.io/cedricziel/truenas-mcp:0.4.2 (OCI, streamable-http) |
| First published | 11 Aug 2026 |
| Last updated | 11 Aug 2026 |
| Registry name | io.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.
