AdGuard Home MCP Server
by samik081io.github.Samik081/mcp-adguard-homev0.10.1
Manage AdGuard Home through AI assistants
context tax
queued
security
queued
cold start
queued
freshness
Active5d ago
Install AdGuard Home MCP server
Install in Claude Code
claude mcp add adguard-home -e ADGUARD_URL='<adguard-url>' -e ADGUARD_USERNAME='<adguard-username>' -e ADGUARD_PASSWORD='<adguard-password>' -- npx -y @samik081/mcp-adguard-homeInstall in Cursor
{
"mcpServers": {
"adguard-home": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-adguard-home"
],
"env": {
"ADGUARD_URL": "<adguard-url>",
"ADGUARD_USERNAME": "<adguard-username>",
"ADGUARD_PASSWORD": "<adguard-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"adguard-home": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-adguard-home"
],
"env": {
"ADGUARD_URL": "<adguard-url>",
"ADGUARD_USERNAME": "<adguard-username>",
"ADGUARD_PASSWORD": "<adguard-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"adguard-home": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@samik081/mcp-adguard-home"
],
"env": {
"ADGUARD_URL": "<adguard-url>",
"ADGUARD_USERNAME": "<adguard-username>",
"ADGUARD_PASSWORD": "<adguard-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"adguard-home": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-adguard-home"
],
"env": {
"ADGUARD_URL": "<adguard-url>",
"ADGUARD_USERNAME": "<adguard-username>",
"ADGUARD_PASSWORD": "<adguard-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ADGUARD_URL | yes | — | URL of the AdGuard Home instance (e.g. http://192.168.1.1:3000) |
| ADGUARD_USERNAME | — | yes | AdGuard Home username (omit if authentication is disabled) |
| ADGUARD_PASSWORD | — | yes | AdGuard Home password (omit if authentication is disabled) |
Freshness
Active — last maintenance signal 5d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-10-05 · 5d ago · GitHub · v0.10.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 5d ago · official registry · v0.10.1
FAQ
›How do I install the AdGuard Home MCP server in Claude Code?
Run: claude mcp add adguard-home -e ADGUARD_URL='<adguard-url>' -e ADGUARD_USERNAME='<adguard-username>' -e ADGUARD_PASSWORD='<adguard-password>' -- npx -y @samik081/mcp-adguard-home. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does AdGuard Home require an API key?
Yes. It expects ADGUARD_URL, ADGUARD_USERNAME, ADGUARD_PASSWORD, of which 2 are secrets.
›Can I use AdGuard Home as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is AdGuard Home in the official MCP registry?
Yes, as io.github.Samik081/mcp-adguard-home.