MCP-NixOS
An MCP server for NixOS resources: search packages and options so the agent does not invent names and settings
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- The server only reads and returns Nix reference data
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-nixosDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal
claude mcp add --transport stdio nixos -- uvx mcp-nixosOr add to the file .mcp.json, in the project
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Run in a terminal
code --add-mcp '{"name":"nixos","type":"stdio","command":"uvx","args":["mcp-nixos"]}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"nixos": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the servers key.
Run in a terminal
codex mcp add nixos -- uvx mcp-nixosOr add to the file ~/.codex/config.toml, for all projects
[mcp_servers.nixos]
command = "uvx"
args = ["mcp-nixos"]If the file already exists, append the block to the end.
Run in a terminal
gemini mcp add -s user nixos uvx mcp-nixosOr add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Add to the file ~/.config/devin/mcp_config.json, for all projects
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.
Formerly Windsurf.
Add to the file cline_mcp_settings.json, for all projects
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.
Add to the file .roo/mcp.json, in the project
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
A fork of Roo Code, same .roo folders.
Add to the file opencode.json, in the project
{
"mcp": {
"nixos": {
"type": "local",
"command": [
"uvx",
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcp key.
Add to the file ~/.config/zed/settings.json, for all projects
{
"context_servers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the context_servers key.
Add to the file .codeassistant/mcp.json, in the project
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
]
}
}
}If the file already exists, add the server inside the mcpServers key.
Add the MCP server via uvx: command uvx, argument mcp-nixos. You can also run it via nix or Docker.
Other ways from the author
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": ["mcp-nixos"]
}
}
}It needs uv installed. There are also nix and Docker options.
This is third-party code. Review the repository files before installing.
What it does
MCP-NixOS gives an agent accurate data about the Nix and NixOS ecosystem: search for packages, configuration options and related resources. The point is that answers rely on the real base rather than invented package names and parameters. The server is written in Python on FastMCP and speaks stdio, launching via uvx from PyPI, via nix straight from the repo, or in Docker. That makes it handy for developers and engineers who build Nix configurations and want the agent to suggest existing packages and options.
Who it is for. For developers and engineers working with Nix and NixOS who want accurate package and option suggestions.
Good fit when
- You need to find a NixOS package or option by name
- The agent confuses Nix package names
- You build a Nix configuration and need real parameters
Not a fit when
- You do not use Nix or NixOS
- You need a tool that changes the system rather than searching resources
Example request
Find the NixOS package for nginx and show which configuration options it hasLimitations
The server returns data about Nix packages and options; it searches them but does not install or change anything on the system. To run it you need uvx, or nix, or Docker. Data freshness depends on the sources the server queries.
How to disable. Remove the nixos server from your MCP config.
MCP
- Transport
- stdio
- Authentication
- not required
Security check
- The server only reads and returns Nix reference data
README in short
The README describes MCP-NixOS as an MCP server that lets an agent search NixOS packages, configuration options and resources so it does not invent names. The server is Python on FastMCP and runs via uvx from PyPI, via nix from the repo, or in Docker. It ships ready client configs and one-click install. MIT licensed.
FAQ
Does it install packages?
No, the server only searches and returns Nix package and option data; installation and changes happen separately.
How do I run it without uvx?
You can use nix directly from the repo with nix run, or run it in Docker.
Related
An MCP server built into the Netdata agent: metrics, logs, alerts and live process, service and container data for an AI assistant
GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent
Agent Skills for Google products
Agent Skills for Google products and technologies
Official Google skill collection for working with Google Cloud, BigQuery, GKE, ads and analytics from an agent
AWS's official MCP server suite: docs, IaC, containers, serverless, databases, cost and monitoring