Which integrations are available for this server?

Provides tools for searching and managing nix-darwin configuration options for [macOS](/mcp/servers/integrations/macos) systems, including searching options, retrieving option details, and reading declaration references. Provides tools for searching and exploring the Nix ecosystem, including package search in Nixpkgs, [NixOS](/mcp/servers/integrations/nixos) configuration options, Home Manager options, Nixvim and nix-darwin configurations, and package version tracking through NixHub. Enables reading Nix source code for derivations and module declarations.

A tasteful MCP server for the Nix ecosystem

Tests

Ecosystem coverage

Nixpkgs
NixOS
Home Manager
Nixvim
nix-darwin
NixHub

Without additional configuration, only Nixpkgs and NixOS categories are included.

Installation

Use the following configuration to add the MCP server to your client:

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

Using Nix

{ "mcpServers": { "nix": { "command": "nix", "args": ["run", "github:felixdorn/mcp-nix"] } } }

Tools

Categories included by default:

Including tools

By category
- Pass the category's ID as an argument: --homemanager --nixvim
By name
- Use --include: --include=list_package_versions,...

Excluding tools

By category
- Prefix the category's ID by "no-": --no-nixos
By name
- Use --exclude: --exclude=find_nixpkgs_commit_with_package_version,...

List of tools

Tool	Usage
nixpkgs
`search_nixpkgs`	Search for Nixpkgs packages by name or description
`show_nixpkgs_package`	Get details for a Nixpkgs package by exact name
`read_derivation` ^a	Read the Nix source code for a package derivation
nixos
`search_nixos_options`	Search NixOS configuration options
`show_nixos_option`	Get details for a NixOS option, or list children if given a prefix
`list_nixos_channels`	List available NixOS release channels
`read_nixos_module` ^a	Read the Nix source code for a NixOS option declaration
homemanager
`search_homemanager_options`	Search Home Manager options for user environment configuration
`show_homemanager_option`	Get details for a Home Manager option, or list children if given a prefix
`list_homemanager_releases`	List available Home Manager releases
`read_home_module` ^a	Read the Nix source code for a Home Manager option declaration
nixvim
`search_nixvim_options`	Search NixVim configuration options
`show_nixvim_option`	Get details for a NixVim option, or list children if given a prefix
`read_nixvim_declaration` ^a	Get the declaration reference for a NixVim option
nix-darwin
`search_nix_darwin_options`	Search nix-darwin configuration options for macOS
`show_nix_darwin_option`	Get details for a nix-darwin option, or list children if given a prefix
`read_nix_darwin_declaration` ^a	Get the declaration reference for a nix-darwin option
nixhub
`list_package_versions`	List all available versions for a Nixpkgs package
`find_nixpkgs_commit_with_package_version`	Get the nixpkgs commit hash for a specific package version

Contributing

Read CONTRIBUTING.md

Credits

Thanks to the NixOS Search Team, ExtraNix, NüschtOS, NixHub for maintaining the backends and pipeline the tool uses and for the Nix community for making any of this possible.

License

GPLv3: License

Requires explicit --include even when the category is enabled.
↩

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Category	ID	Tools
Home Manager	`homemanager`	`search_homemanager_options`, `show_homemanager_option`, `list_homemanager_releases`, `read_home_module` ^a
Nixvim	`nixvim`	`search_nixvim_options`, `show_nixvim_option`, `read_nixvim_declaration` ^a
nix-darwin	`nix-darwin`	`search_nix_darwin_options`, `show_nix_darwin_option`, `read_nix_darwin_declaration` ^a
NixHub	`nixhub`	`list_package_versions`, `find_nixpkgs_commit_with_package_version`

mcp-nix