AdGuard Home MCP Server — Claude Code MCP server: install
This MCP server lets AI assistants manage AdGuard Home settings, from DNS filtering and query logs to clients, DHCP, and rewrites.
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-homeWhat AdGuard Home MCP Server 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.
What it helps with
- 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 for the agent
- 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.
How to install AdGuard Home MCP Server
Platform CLI
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-homeReplace <…> with your own values
Platform CLI
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-homeReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-homeReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AdGuard Home MCP Server
How do I install AdGuard Home MCP Server in Claude Code?
Run `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`.
What does AdGuard Home MCP Server do?
It connects an AI assistant to AdGuard Home and exposes tools for DNS filtering, query logs, clients, DHCP, rewrites, and related settings.
Can I use it for monitoring only?
Yes. Set ADGUARD_ACCESS_TIER=read-only to expose 29 read-only tools and block state changes.
