MCP NixOS

Because your AI shouldn't hallucinate package names.

Give Claude, Codex, and other AI assistants accurate NixOS packages, options, Home Manager modules, and official documentation through MCP.

Read the documentation View on GitHub

Language: Python
License: MIT
Stars: 778
Forks: 42

What it fixes

AI assistants are great right up until they confidently invent a package, option, or module that has never existed. MCP NixOS replaces the vibes with live, authoritative Nix data.

MCP NixOS is the plumbing between AI assistants and the sprawling, fast-moving Nix ecosystem.

Hallucinated package names and versions
Outdated or incorrect NixOS options
Missing Home Manager and nix-darwin modules
Broken links to docs and manual pages

What it actually does

A useful product surface, not another README wearing a blazer.

NixOS packages

Search packages, inspect versions, and retrieve metadata across current channels.

NixOS options

Query types, defaults, declarations, and full option context.

Home Manager

Browse user-level modules and release-specific configuration options.

nix-darwin

Find the macOS options your future self will otherwise swear do not exist.

Nixvim and NVF

Search editor module options without spelunking through generated manuals.

FlakeHub and Noogle

Discover flakes and search Nix functions from the same MCP surface.

Official documentation

Pull relevant NixOS Wiki and nix.dev material into the answer.

One query interface

Use one unified tool instead of teaching every agent a pile of bespoke APIs.

Pick your poison

Run it the way that annoys you least.

uvx

uvx mcp-nixos

Nix

nix run github:utensils/mcp-nixos --

Docker

docker run --rm -i ghcr.io/utensils/mcp-nixos:latest

Plays well with the tools already causing trouble

Claude Desktop
Claude Code
Codex
Cursor
Zed
VS Code
Goose
Windsurf

Under the hood

Simple enough to explain without a thirty-slide architecture deck.

01
Your MCP client

Claude, Codex, an editor, or whatever else currently owns your attention.
02
MCP NixOS

FastMCP exposes a focused, read-only query surface over stdio or HTTP.
03
Authoritative sources

NixOS, Home Manager, nix-darwin, FlakeHub, Noogle, wiki, and docs data.
04
Useful answers

Current package and option results instead of confident synthetic nonsense.

Give your agent real Nix data

Stop fighting invented options and spend that time breaking something more interesting.