TrueNAS MCP (official)
access level: configurable✔ Source-reviewed Oct 2026
We read this project's source code and tool definitions (Oct 2026). This is a code review, not a live test against real systems. Re-check after upgrades.
| Repository | https://github.com/truenas/truenas-mcp |
|---|---|
| Category | Storage/NAS |
| Systems touched | TrueNAS SCALE 25.04+: pools, datasets, snapshots, SMB/NFS shares, VMs, apps, directory services, updates |
| Access (as described) | configurable |
| License / price | GPL-3.0 / free |
| GitHub stars | 103 |
| Read tools | system_info, system_health, query_jobs, query_pools, query_datasets, query_snapshots, query_shares, query_vms, list_alerts, get_system/network/disk/arc_metrics, query_apps, search_app_catalog, analyze_capacity, get_pool_capacity_details, check_updates, query_boot_environments, get_scrub_status, tasks_list/get |
| Write / delete / exec tools | create_dataset, create_smb_share, create_nfs_share, install/update/start app, dismiss/restore alert, run_scrub, create_scrub_schedule, download_update, refresh_directory_cache; destructive (need confirm=true): system_reboot, apply_update, delete_boot_environment, delete_app, stop_app, upgrade_app, configure/leave_directory_service, delete_scrub_schedule |
| Read-only mode | Yes: --read-only / TRUENAS_MCP_READ_ONLY hides and refuses every write tool; --allow-tools / --deny-tools lists; dry_run on all writes; destructive tools return a preview until called with confirm=true |
| Safety notes | README tells you to use an admin API key, so run with --read-only unless you need changes. confirm=true is set by the model, so keep client-side approval on for destructive tools. Never use --insecure; trust the self-signed cert with --tls-ca. Debug logs redact credentials. |
| Verified | yes (README review 2026-10-31) |
| Notes | Official iXsystems/TrueNAS project, labelled "research preview, not recommended for production". Single Go binary, connects over wss:// only. Created Feb 2026, actively updated (commit 27 Oct 2026). Added 2026-10-31. |
📬 SysAdmin Agents
The SysAdmin Agents newsletter: new MCP servers, agent skills and safety notes for sysadmins. One email a week.