truenas-mcp MCP Server

Wiring a NAS into an AI assistant usually means registering one MCP tool per operation. Cover TrueNAS SCALE properly and that is 50-80 tool schemas — around 28,000 tokens of your context window…

Local serverstdioMIT

What is the truenas-mcp Server?

truenas-mcp is an MCP project maintained in the spranab/truenas-mcp repository. The maintainer describes its purpose as “Wiring a NAS into an AI assistant usually means registering one MCP tool per operation. Cover TrueNAS SCALE properly and that is 50-80 tool schemas…”. Read the project documentation for the complete scope.

Installation

The documented npm package is truenas-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TRUENAS_URL, TRUENAS_API_KEY, TRUENAS_VERIFY_SSL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the truenas-mcp Server

{
  "mcpServers": {
    "truenas": {
      "command": "npx",
      "args": [
        "-y",
        "truenas-mcp"
      ],
      "env": {
        "TRUENAS_URL": "https://truenas.local",
        "TRUENAS_API_KEY": "YOUR_TRUENAS_API_KEY",
        "TRUENAS_VERIFY_SSL": "false"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
TRUENAS_URL	Declared in the maintainer’s client configuration.	Yes
TRUENAS_API_KEY	Declared in the maintainer’s client configuration.	Yes
TRUENAS_VERIFY_SSL	Declared in the maintainer’s client configuration.	Optional