MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages
About
A server for searching NixOS, Home Manager, and nix-darwin resources.
Details
- Author
- utensils
- GitHub stars
- 739
- Downloads
- 1,288
- Categories
- Search, Knowledge Base, Infrastructure, AI
Jump to
- Two consolidated tools (~1030 tokens total).
- No Nix installation required (runs anywhere Python runs).
- Queries 130K+ packages and 23K+ NixOS options.
- Supports STDIO and HTTP transports.
- Includes binary cache status checking.
- Accesses FlakeHub, Noogle, NixOS Wiki, nix.dev, and NixHub.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About PackagesCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install and run via uvx mcp-nixos (recommended), pip install mcp-nixos, nix run github:utensils/mcp-nixos, or Docker (ghcr.io/utensils/mcp-nixos). Configure as an MCP server in your client (e.g., Cursor, Claude, Pi) using the nixos server name. Two tools are provided: nix (unified query with actions like search, info, stats, cache, flake-inputs) and nix_versions (package version history). Transport defaults to STDIO; set environment variables MCP_NIXOS_TRANSPORT=http and optionally MCP_NIXOS_HOST, MCP_NIXOS_PORT, MCP_NIXOS_PATH, MCP_NIXOS_STATELESS_HTTP for HTTP mode.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-nixos - because your ai assistant shouldn't hallucinate about packages": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}
}McpServers
{
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}MCP-NixOS - Because Your AI Shouldn't Hallucinate Package Names
Quick Start
🚨 No Nix/NixOS Required! Works on any system - Windows, macOS, Linux. You're just querying APIs.
Option 1: uvx (Recommended)
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": ["mcp-nixos"]
}
}
}
Option 2: Nix
{
"mcpServers": {
"nixos": {
"command": "nix",
"args": ["run", "github:utensils/mcp-nixos", "--"]
}
}
}
Option 3: Docker
{
"mcpServers": {
"nixos": {
"command": "docker",
"args": ["run", "--rm", "-i", "ghcr.io/utensils/mcp-nixos"]
}
}
}
Your AI now has access to real NixOS data instead of making things up. You're welcome.
Option 4: HTTP (Remote MCP)
FastMCP supports running this server over HTTP at a URL (the MCP endpoint defaults to /mcp).
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
