AdGuard Home MCP Server

● Active

io.github.Samik081/mcp-adguard-home

Manage AdGuard Home through AI assistants

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mcp-adguard-home": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-adguard-home@0.11.0"
      ],
      "env": {
        "ADGUARD_URL": "<your ADGUARD_URL>",
        "ADGUARD_USERNAME": "<your ADGUARD_USERNAME>",
        "ADGUARD_PASSWORD": "<your ADGUARD_PASSWORD>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env ADGUARD_URL='<your ADGUARD_URL>' --env ADGUARD_USERNAME='<your ADGUARD_USERNAME>' --env ADGUARD_PASSWORD='<your ADGUARD_PASSWORD>' --transport stdio mcp-adguard-home -- npx -y @samik081/mcp-adguard-home@0.11.0
OpenAI Codex CLI
codex mcp add mcp-adguard-home --env ADGUARD_URL='<your ADGUARD_URL>' --env ADGUARD_USERNAME='<your ADGUARD_USERNAME>' --env ADGUARD_PASSWORD='<your ADGUARD_PASSWORD>' -- npx -y @samik081/mcp-adguard-home@0.11.0
VS Code
code --add-mcp '{"name":"mcp-adguard-home","type":"stdio","command":"npx","args":["-y","@samik081/mcp-adguard-home@0.11.0"],"env":{"ADGUARD_URL":"<your ADGUARD_URL>","ADGUARD_USERNAME":"<your ADGUARD_USERNAME>","ADGUARD_PASSWORD":"<your ADGUARD_PASSWORD>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • ADGUARD_URLrequiredURL of the AdGuard Home instance (e.g. http://192.168.1.1:3000)
  • ADGUARD_USERNAMEsecretAdGuard Home username (omit if authentication is disabled)
  • ADGUARD_PASSWORDsecretAdGuard Home password (omit if authentication is disabled)

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Other
Version
0.11.0
Registry
active
Published
11/12/2026

On GitHub

read Nov 17, 2026
Stars
15
Forks
2
Last push
Nov 12, 2026
License
MIT

TypeScriptadguardadguard-homeadguardhomeclaude-codecoding-assistantmcpmcp-servermodel-context-protocol

From the README

MCP AdGuard Home MCP server for AdGuard Home. Manage DNS filtering, clients, DHCP, rewrites, and more through natural language in Cursor, Claude Code, and Claude Desktop. Features • 65 tools across 16 categories covering the complete AdGuard Home API • Read-only mode via ADGUARDACCESSTIER=read-only for safe monitoring • Category filtering via ADGUARD_CATEGORIES to expose only the tools you need • Zero HTTP dependencies -- uses native fetch (Node.js 22+) • Docker images for linux/amd64 and linux/arm64 on GHCR • Remote MCP via HTTP transport (MCP_TRANSPORT=http) using the Streamable HTTP protocol • TypeScript/ESM with full type safety API Compatibility Tested with AdGuard Home v0.107.76. Quick Start Run the server directly with npx: The server validates your AdGuard Home connection on startup and fails immediately with a clear error if credentials are missing or invalid. Docker Run with Docker (stdio transport, same as npx): To run as a remote MCP server with HTTP transport: The MCP endpoint is available at http://localhost:3000 and a health check at http://localhost:3000/health. Security: the HTTP transport has no authentication -- anyone who can reach the port can call every enabled tool. Keep it on loopback or a trusted network, or put it behind an authenticating reverse proxy. Outside Docker the server binds to 127.0.0.1 by default and only accepts requests whose Host/Origin is a loopback name (DNS rebinding protection).…

Read the full README on GitHub →

Alternatives to AdGuard Home MCP Server

Best Other servers →

The most-starred Other servers in the index, with their live-check result.

ServerStarsLast pushLive check
Labelhead Artist Momentum114,594Nov 2026Working
World Monitor90,614Nov 2026Needs sign-in
Tldraw51,470Nov 2026Working
MCP Server Commands39,602Oct 2026Local / not checked
OpenSEO27,693Nov 2026Needs sign-in

AdGuard Home MCP Server: questions people ask

Is AdGuard Home MCP Server a remote or a local MCP server?
According to its entry in the official MCP registry, AdGuard Home MCP Server ships as a local package (npm, Docker) that your client starts on your machine.
Does AdGuard Home MCP Server need an API key?
Its registry entry declares 6 required environment variables: ADGUARD_URL, ADGUARD_USERNAME, ADGUARD_PASSWORD, ADGUARD_URL…. The config on this page shows where each goes.
Is AdGuard Home MCP Server still maintained?
Active: the repository's last commit 8 days ago. Last push Nov 12, 2026, 15 GitHub stars, MIT licence. Read from GitHub on Nov 17, 2026.
How do I add AdGuard Home MCP Server to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Other →

Add the badge to your site

Show visitors that AdGuard Home MCP Server is listed here — it’s also the link we check for a free listing.

AdGuard Home MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-samik081-mcp-adguard-home?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="AdGuard Home MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![AdGuard Home MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-samik081-mcp-adguard-home?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).