# AdGuard Home MCP Server

This MCP server lets AI assistants manage AdGuard Home settings, from DNS filtering and query logs to clients, DHCP, and rewrites.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: Samik081
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Samik081/mcp-adguard-home
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/adguard-home-mcp-server

## What it does

The server exposes AdGuard Home operations to an AI assistant through natural-language requests. Its 65 tools cover 16 categories, including DNS, filtering, query logs, statistics, clients, DHCP, rewrites, and access settings.

The `full` tier permits reads and state changes. Set `ADGUARD_ACCESS_TIER=read-only` to expose 29 monitoring tools without write operations. Categories and individual tools can be narrowed with environment variables, so the assistant sees only the surface you choose.

You can run it with `npx` or Docker over stdio or HTTP. `ADGUARD_URL` is required, while admin credentials are used when authentication is enabled in AdGuard Home. The server checks the connection during startup, so invalid credentials prevent it from starting.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ADGUARD_URL`, `ADGUARD_USERNAME`, `ADGUARD_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-adguard-home -e ADGUARD_URL=<ADGUARD_URL> -e ADGUARD_USERNAME=<ADGUARD_USERNAME> -e ADGUARD_PASSWORD=<ADGUARD_PASSWORD> -- npx -y @samik081/mcp-adguard-home
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add adguard-home-mcp-server --env ADGUARD_URL=<ADGUARD_URL> --env ADGUARD_USERNAME=<ADGUARD_USERNAME> --env ADGUARD_PASSWORD=<ADGUARD_PASSWORD> -- npx -y @samik081/mcp-adguard-home
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adguard-home-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@samik081/mcp-adguard-home"
            ],
            "env": {
                "ADGUARD_URL": "<ADGUARD_URL>",
                "ADGUARD_USERNAME": "<ADGUARD_USERNAME>",
                "ADGUARD_PASSWORD": "<ADGUARD_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adguard-home-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@samik081/mcp-adguard-home"
            ],
            "env": {
                "ADGUARD_URL": "<ADGUARD_URL>",
                "ADGUARD_USERNAME": "<ADGUARD_USERNAME>",
                "ADGUARD_PASSWORD": "<ADGUARD_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ADGUARD_URL=<ADGUARD_URL> -e ADGUARD_USERNAME=<ADGUARD_USERNAME> -e ADGUARD_PASSWORD=<ADGUARD_PASSWORD> adguard-home-mcp-server npx -y @samik081/mcp-adguard-home
```
Replace <…> with your own values

## When to use it
- manage AdGuard Home DNS filtering from an AI assistant
- inspect DNS query logs and service statistics
- configure clients and DHCP settings
- edit domain rewrite rules
- limit the assistant to read-only monitoring

## Example prompts
- Show the current AdGuard Home DNS settings and recent query-log entries.
- Add a rewrite rule for the domain I provide.
- Inspect clients and DHCP without changing server state.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md