# A complete MCP server for Nix*
[](https://github.com/felixdorn/mcp-nix/actions/workflows/test.yml)
## Features
* **Search Nixpkgs and read package derivations**
* **Broad options coverage**
* NixOS
* Home Manager
* Nix Darwin
* Other: Nixvim Impermanence, MicroVM.nix, nix-nomad, simple-nixos-mailserver, sops-nix, nixos-hardware, disko.
* **Search the nix standard library and read function definitions**
* **Find versions of nixpkgs in which a package exists**
## Installation
Use the following configuration to add the MCP server to your client:
**Using uvx:**
```json
{
"mcpServers": {
"nix": {
"command": "uvx",
"args": ["mcp-nix"]
}
}
}
```
[Add to cursor](https://cursor.com/en-US/install-mcp?name=nix&config=eyJjb21tYW5kIjoidXZ4IG1jcC1uaXgifQ%3D%3D)
**Using nix run:**
```json
{
"mcpServers": {
"nix": {
"command": "nix",
"args": ["run", "github:felixdorn/mcp-nix"]
}
}
}
```
[Add to cursor](https://cursor.com/en-US/install-mcp?name=nix&config=eyJjb21tYW5kIjoibml4IHJ1biBnaXRodWI6ZmVsaXhkb3JuL21jcC1uaXgifQ%3D%3D)
**Declaratively:**
Add the flake input:
```nix
{
inputs.mcp-nix.url = "github:felixdorn/mcp-nix";
}
```
Then reference the package:
```nix
{
command = "${inputs.mcp-nix.packages.${system}.default}/bin/mcp-nix";
}
```
### Tools
| Tool | Description |
|------|-------------|
| `search_nixpkgs` | Search Nixpkgs packages |
| `read_derivation` | Read package source code |
| `search_options` | Search options for many projects |
| `list_versions` | List available versions for a project |
| `show_option_details` | Get option details or list children |
| `read_option_declaration` | Read option source code |
| `find_nixpkgs_commit_with_package_version` | Get nixpkgs commit for a version, shows available versions if not found (NixHub) |
| `search_nix_stdlib` | Search Nix stdlib functions (Noogle) |
| `help_for_stdlib_function` | Get help for a stdlib function (Noogle) |
### Excluding Tools
Use `--exclude` to disable specific tools:
```json
{
"mcpServers": {
"nix": {
"command": "uvx",
"args": ["mcp-nix", "--exclude=read_derivation,read_option_declaration"]
}
}
}
```
### Contributing
Read [CONTRIBUTING.md](CONTRIBUTING.md)
### Acknowledgments
Thanks to the [NixOS Search Team](https://search.nixos.org), [ExtraNix](https://extranix.com), [NüschtOS](https://github.com/NuschtOS/search), [nix-nomad](https://github.com/tristanpemble/nix-nomad), [NixHub](https://nixhub.io), [Noogle](https://noogle.dev) for maintaining the backends and pipeline this server uses and for the Nix community for making any of this possible.
### License
GPLv3: [License](LICENSE)
<!-- mcp-name: io.github.felixdorn/mcp-nix -->
