Repolode
Submit
utensils

utensils/mcp-nixos

An MCP server that gives AI assistants accurate, live lookups of NixOS packages, options, Home Manager settings and other Nix resources.

View on GitHubWebsite
Stars
864
Forks
46
Open issues
1
Last commit
2 months ago

What is it?

MCP-NixOS is a Model Context Protocol server that lets AI assistants such as Claude query NixOS data directly, so they can look up real package names and configuration options instead of guessing them. It covers NixOS packages and options, Home Manager, nix-darwin, Nixvim, NVF, FlakeHub, Noogle, the NixOS Wiki, nix.dev, and package version history via NixHub, along with binary cache status checks.

The server exposes just two tools: a unified `nix` tool with actions such as search, info, stats, browse and cache, and a `nix_versions` tool for historical package versions with nixpkgs commit hashes. It runs over STDIO by default or over HTTP, and can be launched with uvx, pip, Nix, or Docker. Querying the remote data sources does not require Nix to be installed, though local flake-input and store browsing do.

Key features

  • 01Searches NixOS packages, options and programs, plus Home Manager and nix-darwin options.
  • 02Covers Neovim configuration via Nixvim and NVF option sets.
  • 03Looks up Noogle function signatures, NixOS Wiki articles and nix.dev docs.
  • 04Finds historical package versions with nixpkgs commit hashes.
  • 05Checks binary cache status on cache.nixos.org, including download sizes.
  • 06Runs over STDIO or HTTP and installs via uvx, pip, Nix or Docker.

Use cases

  • Asking an AI assistant to write a NixOS or Home Manager configuration with correct option names.
  • Confirming a package exists and finding the right attribute name before adding it to a config.
  • Pinning an older package version by locating its nixpkgs commit hash.
  • Looking up Nix library functions and their type signatures while coding.

Quick start

  1. 1

    Add the uvx-based server config to your MCP client

  2. 2

    Or install the package with pip

    pip install mcp-nixos

Things to know

  • Requires Nix only for the local flake-inputs and store actions; the rest queries public APIs.

Topics

#mcp#nixos#nix#ai-tools#model-context-protocol#llm-tools#package-search#developer-tools#ai-assistant#ai-integration

FAQ

What is mcp-nixos?
An MCP server that gives AI assistants accurate, live lookups of NixOS packages, options, Home Manager settings and other Nix resources. MCP-NixOS is a Model Context Protocol server that lets AI assistants such as Claude query NixOS data directly, so they can look up real package names and configuration options instead of guessing them. It covers NixOS packages and options, Home Manager, nix-darwin, Nixvim, NVF, FlakeHub, Noogle, the NixOS Wiki, nix.dev, and package version history via NixHub, along with binary cache status checks.
Is mcp-nixos free to use? What license does it have?
mcp-nixos is open source under the MIT license. Check the license terms before using it in commercial products.
Is mcp-nixos still maintained?
Updated within 6 months. The last commit to mcp-nixos was on Sep 5, 2026.
What can I use mcp-nixos for?
Asking an AI assistant to write a NixOS or Home Manager configuration with correct option names. Confirming a package exists and finding the right attribute name before adding it to a config. Pinning an older package version by locating its nixpkgs commit hash. Looking up Nix library functions and their type signatures while coding.
How do I install mcp-nixos?
Add the uvx-based server config to your MCP client Or install the package with pip: pip install mcp-nixos
Where can I get mcp-nixos?
The source code and installation instructions are on GitHub: https://github.com/utensils/mcp-nixos

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects