Skip to content

Summary

MCP server that gives AI assistants accurate NixOS packages and options, Home Manager, nix-darwin, Nixvim, FlakeHub flakes and Nix functions, no Nix install needed.

Features

  • NixOS packages and options from live channels
  • Home Manager, nix-darwin, Nixvim and NVF options
  • FlakeHub flakes, noogle.dev functions and the NixOS Wiki
  • No Nix required: runs with uvx, nix run or Docker
  • stdio or streamable HTTP via FastMCP

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "MCP-NixOS" tools will be available.
{
  "mcpServers": {
    "mcp-nixos": {
      "command": "uvx",
      "args": [
        "mcp-nixos"
      ]
    }
  }
}

Description

MCP-NixOS stops AI assistants from inventing Nix package names and configuration options. It queries live sources and returns real data, and because it only calls APIs it runs on Windows, macOS or Linux without Nix installed.

Sources
  • NixOS packages (130K+) and NixOS options (23K+).
  • Home Manager options (5K+) and nix-darwin macOS settings (1K+).
  • Nixvim (via NuschtOS search) and NVF Neovim options.
  • FlakeHub flakes, Nix functions with type signatures from noogle.dev, and the NixOS Wiki.
Setup

The recommended way is uvx mcp-nixos; it is also available through nix run github:utensils/mcp-nixos -- and as a Docker image (ghcr.io/utensils/mcp-nixos). Built on FastMCP, it can serve streamable HTTP (MCP_NIXOS_TRANSPORT=http, /mcp on port 8000 by default) as well as stdio, and the repository includes a path for the Pi coding agent.

Who it is for

Anyone writing NixOS, Home Manager or nix-darwin configuration with an AI assistant who wants option names and package attributes checked against the real channels. MIT-licensed, maintained by utensils.

Related MCP Servers

See all MCP-NixOS alternatives

MCP: Couchbase Guru

by Couchbase

Couchbase's documentation agent as a single MCP tool: ask a question about any Couchbase product, SDK or version and get an answer with source links. No cluster and no credentials.

Featured

Google's official MCP server for driving the gcloud CLI from natural language, with allowlist and denylist controls over which commands an agent may run.

Browse all MCP servers →