mcp server

nix-agent

Agent MCP server + skill for managing your NixOS system

JEFF7712/nix-agentcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nix-agent": {
      "command": "uvx",
      "args": [
        "nix-agent"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 18, 2026

A local MCP server that gives AI agents composable NixOS / Home Manager operations: build, diff, switch, and generations for the operational core, plus eval, locate, and check for config introspection.

It pairs with mcp-nixos. nix-agent operates on your actual configuration, mcp-nixos handles package and option discovery. Optional local usage logging (NIX_AGENT_USAGE_LOG=1) records per-call byte accounting; run nix-agent usage to summarize.

The documented default is high trust: unprompted switch / generations and passwordless sudo narrowed to this machine's flake. Lower trust (host prompts, a sudo password) is an opt-down.

Experimental and a work in progress. Feedback and contributions welcome.

Install

Paste this to a coding agent (Codex, Claude Code, opencode, ...) and it does the install:

Read https://raw.githubusercontent.com/JEFF7712/nix-agent/main/docs/agent-install.md and follow every step to install nix-agent on this NixOS system, install the companion skills, and register nix-agent in my MCP settings for this machine.

Or do it by hand, see docs/usage.md.

Docs

docs/usage.md: install, MCP host config, tool surface, workflow, design notes
docs/agent-install.md: high-trust install guide for agents
docs/privileged-automation.md: default non-interactive dry-activate, switch, and rollback (opt-down for a sudo password)
skills/nix-agent/SKILL.md: companion workflow skill
skills/nix-agent-init/SKILL.md: repo onboarding skill

The published documentation pages are generated directly from these Markdown files.

The nix-agent logo adapts the Nix snowflake from NixOS/nixos-artwork, licensed CC-BY 4.0.