Mcp Nixos logo

Mcp Nixos

Free

MCP-NixOS - Model Context Protocol Server for NixOS resources

FreeFree tier
#Python
Inputs: textOutputs: text
Type
Saas

About Mcp Nixos

MCP-NixOS is a Model Context Protocol server that provides AI assistants with real-time, accurate information about NixOS packages, options, Home Manager, nix-darwin, flakes, and more. It exposes two MCP tools (nix and nix_versions) that query multiple authoritative sources including search.nixos.org, NixHub, cache.nixos.org, FlakeHub, noogle.dev, NuschtOS (Nixvim), wiki.nixos.org, and nix.dev. With token-efficient responses (~1,030 tokens total) and no requirement for Nix installation, it works on any operating system and integrates with MCP-compatible clients like Claude and Cursor. Responses are delivered as plain text for easy parsing by LLMs, and the server can be run locally over STDIO or hosted remotely over HTTP.

Key Features

Search and inspect 130K+ packages and 23K+ system options
Home Manager with 5K+ user-level options
nix-darwin macOS settings (1K+ options)
Flakes & FlakeHub search via search.nixos.org and Determinate Systems registry
Noogle + Nixvim: 2K+ Nix function signatures and 5K+ Nixvim options
Package version history with nixpkgs commit hashes via NixHub.io
Binary cache status check for cache.nixos.org
Works with Claude, Cursor, and other MCP clients
~1,030 tokens total (low context usage)
No Nix required to run; works on Windows, macOS, Linux

Pros & Cons

Pros
  • Real-time, up-to-the-second information from multiple authoritative sources
  • Extremely low token usage (~1,030 tokens total) reduces context waste
  • No Nix installation required; works on any OS
  • Works with popular MCP clients like Claude and Cursor
  • Supports both STDIO and HTTP deployment for flexibility
  • Plain text responses for easy parsing by LLMs
  • Open source and free to use
Cons
  • Requires an MCP-compatible client to function
  • Plain text output may require additional parsing for structured data use
  • Limited to two MCP tools (though one is a unified query tool)
  • Depends on external source availability for some queries

Best For

Stop guessing Nix package attribute names when writing Nix expressionsFind historical package versions for compatibility or rollbackCheck binary cache status before building to save timeExplore Home Manager options for customizing user environmentsDiscover nix-darwin settings for macOS system configurationQuery community Nix expressions and official tutorials for learningIntegrate NixOS data into AI-assisted development workflows

FAQ

What is MCP-NixOS?
MCP-NixOS is a Model Context Protocol server that gives AI assistants real-time access to NixOS packages, options, Home Manager, nix-darwin, flakes, and more. It exposes two MCP tools (nix and nix_versions) that query multiple official and community sources.
Do I need to have Nix installed to use it?
No, MCP-NixOS is an API client and does not require Nix to be installed. It works on Windows, macOS, and Linux.
How many tokens does it use?
Approximately 1,030 tokens total, making it very context-efficient.
What sources does it query?
It queries search.nixos.org, NixHub.io, cache.nixos.org, FlakeHub, noogle.dev, NuschtOS (Nixvim), wiki.nixos.org, nix.dev, and local /nix/store for pinned flake inputs.
How do I set it up?
Add the provided JSON configuration to your MCP client config. For example, use the command 'uvx mcp-nixos' for STDIO mode. Alternative deployment methods are documented on the site.