Pi-hole MCP Server

Name: Pi-hole MCP Server
Author: hexamatic

von hexamaticVersion 0.10.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.hexamatic/pihole-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Manage Pi-hole v6: DNS blocking, domains, clients, query analysis, DHCP, and multi-instance sync.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: PIHOLE_URL, PIHOLE_PASSWORD

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: PIHOLE_URL, PIHOLE_PASSWORD, TZ, PIHOLE_READ_ONLY, PIHOLE_TLS_SKIP_VERIFY, PIHOLE_REQUEST_TIMEOUT, PIHOLE_MAX_RETRIES, PIHOLE_RETRY_MAX_DELAY

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

DockerDocker installiert

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "pihole": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PIHOLE_URL",
        "-e",
        "PIHOLE_PASSWORD",
        "-e",
        "TZ",
        "-e",
        "PIHOLE_READ_ONLY",
        "-e",
        "PIHOLE_TLS_SKIP_VERIFY",
        "-e",
        "PIHOLE_REQUEST_TIMEOUT",
        "-e",
        "PIHOLE_MAX_RETRIES",
        "-e",
        "PIHOLE_RETRY_MAX_DELAY",
        "ghcr.io/hexamatic/pihole-mcp:0.10.0"
      ],
      "env": {
        "PIHOLE_URL": "your-value",
        "PIHOLE_PASSWORD": "your-value",
        "TZ": "your-value",
        "PIHOLE_READ_ONLY": "your-value",
        "PIHOLE_TLS_SKIP_VERIFY": "your-value",
        "PIHOLE_REQUEST_TIMEOUT": "your-value",
        "PIHOLE_MAX_RETRIES": "your-value",
        "PIHOLE_RETRY_MAX_DELAY": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add pihole --env PIHOLE_URL=your-value --env PIHOLE_PASSWORD=your-value --env TZ=your-value --env PIHOLE_READ_ONLY=your-value --env PIHOLE_TLS_SKIP_VERIFY=your-value --env PIHOLE_REQUEST_TIMEOUT=your-value --env PIHOLE_MAX_RETRIES=your-value --env PIHOLE_RETRY_MAX_DELAY=your-value -- docker run -i --rm -e PIHOLE_URL -e PIHOLE_PASSWORD -e TZ -e PIHOLE_READ_ONLY -e PIHOLE_TLS_SKIP_VERIFY -e PIHOLE_REQUEST_TIMEOUT -e PIHOLE_MAX_RETRIES -e PIHOLE_RETRY_MAX_DELAY ghcr.io/hexamatic/pihole-mcp:0.10.0

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "pihole": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PIHOLE_URL",
        "-e",
        "PIHOLE_PASSWORD",
        "-e",
        "TZ",
        "-e",
        "PIHOLE_READ_ONLY",
        "-e",
        "PIHOLE_TLS_SKIP_VERIFY",
        "-e",
        "PIHOLE_REQUEST_TIMEOUT",
        "-e",
        "PIHOLE_MAX_RETRIES",
        "-e",
        "PIHOLE_RETRY_MAX_DELAY",
        "ghcr.io/hexamatic/pihole-mcp:0.10.0"
      ],
      "env": {
        "PIHOLE_URL": "your-value",
        "PIHOLE_PASSWORD": "your-value",
        "TZ": "your-value",
        "PIHOLE_READ_ONLY": "your-value",
        "PIHOLE_TLS_SKIP_VERIFY": "your-value",
        "PIHOLE_REQUEST_TIMEOUT": "your-value",
        "PIHOLE_MAX_RETRIES": "your-value",
        "PIHOLE_RETRY_MAX_DELAY": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "pihole": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PIHOLE_URL",
        "-e",
        "PIHOLE_PASSWORD",
        "-e",
        "TZ",
        "-e",
        "PIHOLE_READ_ONLY",
        "-e",
        "PIHOLE_TLS_SKIP_VERIFY",
        "-e",
        "PIHOLE_REQUEST_TIMEOUT",
        "-e",
        "PIHOLE_MAX_RETRIES",
        "-e",
        "PIHOLE_RETRY_MAX_DELAY",
        "ghcr.io/hexamatic/pihole-mcp:0.10.0"
      ],
      "env": {
        "PIHOLE_URL": "your-value",
        "PIHOLE_PASSWORD": "your-value",
        "TZ": "your-value",
        "PIHOLE_READ_ONLY": "your-value",
        "PIHOLE_TLS_SKIP_VERIFY": "your-value",
        "PIHOLE_REQUEST_TIMEOUT": "your-value",
        "PIHOLE_MAX_RETRIES": "your-value",
        "PIHOLE_RETRY_MAX_DELAY": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

PIHOLE_URL erforderlich env
Base URL of your Pi-hole web interface. For multiple Pi-holes use PIHOLE_1_URL, PIHOLE_2_URL, ... instead.
PIHOLE_PASSWORD geheim erforderlich env
Pi-hole admin password, or an application password (recommended — bypasses TOTP 2FA)
TZ env
IANA timezone for rendered timestamps, e.g. Australia/Adelaide. Defaults to UTC in the container.
PIHOLE_READ_ONLY env
Expose only inspection tools. Every tool that can change Pi-hole is hidden and rejected if called.
PIHOLE_TLS_SKIP_VERIFY env
Set to true only for a Pi-hole serving a self-signed HTTPS certificate. A trusted certificate is the better fix.
PIHOLE_REQUEST_TIMEOUT env
HTTP request timeout as a Go duration, e.g. 30s or 1m
PIHOLE_MAX_RETRIES env
Retries after a transient Pi-hole API failure; 0 disables retrying
PIHOLE_RETRY_MAX_DELAY env
Upper bound on a single exponential-backoff wait, as a Go duration

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto hexamatic bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32691 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 86 % der anderen 32691 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32691 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Pi-hole MCP Server sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: PIHOLE_URL, PIHOLE_PASSWORD

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.10.0) kam vor 5 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Dialyne

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert vorgestern

Installieren

Dialyne

von dialyne

Real phone calls in France for AI agents: dial +33 numbers, menus, hold, AI disclosure.

Läuft in der CloudAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

pihole-mcp

A production-grade MCP server for Pi-hole v6.

Gives AI assistants full control over your Pi-hole instance: DNS blocking, domain management, query analysis, statistics, network devices, DHCP, and system administration. Compatible with the Pi-hole v6 REST API.

Why this one

Run it locked down. PIHOLE_READ_ONLY=true exposes only the tools that cannot change anything, enforced on every call, not just the tool list a client happens to cache. PIHOLE_TOOLSETS narrows further to just the families you need, so a client asking "what can I use" gets a smaller, cheaper answer.
82 tools (84 once a second Pi-hole is configured) covering roughly 95% of the Pi-hole v6 REST API, including domains, lists, groups, clients, DHCP, network, the query log, configuration, local DNS records, teleporter backup and restore, and session management.
Multi-instance diff and sync. Compare two Pi-holes and see exactly what differs, or reconcile one onto the other with a dry-run plan and a confirm token before anything is written.
Releases are signed and attested, not just built. Every archive and container image carries a keyless cosign signature, an SPDX SBOM and SLSA build provenance, and SECURITY.md has the one-line command to check each.
Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/) as io.github.hexamatic/pihole-mcp, installable by name from any client that supports registry install.
Shipped nine releases in five months since launch, each with real release notes describing what changed and why, not a commit-hash dump.

Quick Start

Most MCP clients use the same configuration format. Add this to your client's config:

"mcpServers": { "pihole": { "command": "pihole-mcp", "env": { "PIHOLE_URL": "http://192.168.1.2", "PIHOLE_PASSWORD": "your-password" } } } }

Then install the binary via one of the methods below.

What you can ask

The whole point is natural language, not tool names. A few examples of what to actually type:

You ask	What runs
"Is Pi-hole blocking right now, and for how long?"	`pihole_dns_get_blocking`
"Pause blocking for 10 minutes, I need to test something."	`pihole_dns_set_blocking`
"Why is reddit.com blocked? Check every list it could be on."	`pihole_search_domains`
"What are the top blocked domains today, and does anything look like a false positive?"	`pihole_stats_recent_blocked`, the `review_top_blocked` prompt
"Point nas.home at 192.168.1.50."	`pihole_local_dns_add`
"Which of my blocklists haven't updated in 30+ days?"	`pihole_lists_list`
"Show me devices on the network Pi-hole doesn't recognise."	`pihole_network_devices`, the `audit_network` prompt
"Compare my two Pi-holes and tell me what's different."	`pihole_instance_diff`
"Back up my configuration before I change anything."	`pihole_teleporter_export`
"Which upstream resolver is slowest, and is it worth switching?"	`pihole_stats_upstreams`, the `upstream_health` prompt

Set PIHOLE_READ_ONLY=true first if you want to ask questions without any risk of something being changed. See Scoping the tool surface.

Installation

MCP Registry

pihole-mcp is listed in the official MCP Registry as:

io.github.hexamatic/pihole-mcp

Clients that support registry install can add it by that name and will prompt for PIHOLE_URL and PIHOLE_PASSWORD. The listing points at the ghcr.io image, so the client needs a working Docker.

Homebrew

brew install hexamatic/tap/pihole-mcp

Installs on both macOS and Linux (Homebrew on Linux). On macOS the cask clears the quarantine attribute during install, so the binary runs without a Gatekeeper prompt. From v0.10.0 the macOS binaries need macOS 13 Ventura or later; v0.9.0 is the last release that runs on macOS 12.

Scoop (Windows)

scoop bucket add hexamatic https://github.com/hexamatic/scoop-bucket

scoop install pihole-mcp

Go Install

go install github.com/hexamatic/pihole-mcp/cmd/pihole-mcp@latest

Docker

docker pull ghcr.io/hexamatic/pihole-mcp:latest

Linux Packages

.deb and .rpm packages for Debian-based (Ubuntu, Raspberry Pi OS) and RPM-based (Fedora, RHEL) distributions are available on the Releases page.

# Debian / Ubuntu / Raspberry Pi OS

sudo dpkg -i pihole-mcp_X.Y.Z_linux_amd64.deb

Fedora / RHEL / CentOS

sudo rpm -i pihole-mcp_X.Y.Z_linux_amd64.rpm

Binary Download

Pre-built binaries for Linux, macOS 13 or later, and Windows (amd64 and arm64) are available on the Releases page.

Releases are checksummed, signed with keyless cosign, and ship SPDX SBOMs and SLSA build provenance. See SECURITY.md for the verification commands.

Check your setup

Once installed and configured, run the server directly with -check. It loads the configuration, contacts every Pi-hole you have configured, and reports each one by name:

PIHOLE_URL=http://192.168.1.2 PIHOLE_PASSWORD=your-password pihole-mcp -check

pihole-mcp 0.10.0

PASS primary (http://192.168.1.2) core v6.5, FTL v6.8

All 1 instance(s) reachable and authenticated.

It exits non-zero if any instance fails, and prints what to change. It also warns when a Pi-hole runs an FTL release affected by published security advisories, naming the release that fixes them. Worth running before you wire the server into a client: most clients hide the server's output, so a bad URL or password looks the same as a server that never started.

Configuration

Variable	Required	Default	Description
`PIHOLE_URL`	Yes	-	Pi-hole base URL (e.g. `http://192.168.1.2`)
`PIHOLE_PASSWORD`	Yes	-	Admin password or application password
`PIHOLE_READ_ONLY`	No	`false`	Expose only tools that cannot change Pi-hole. See Scoping the tool surface.
`PIHOLE_TOOLSETS`	No	all	Comma-separated toolset names to expose, e.g. `dashboard,domains`. Unset or `all` exposes everything.
`PIHOLE_REQUEST_TIMEOUT`	No	`30s`	HTTP request timeout
`PIHOLE_MAX_RETRIES`	No	`3`	Retries after a failed Pi-hole API call. `0` disables.
`PIHOLE_RETRY_MAX_DELAY`	No	`8s`	Upper bound on a single backoff wait.
`PIHOLE_HTTP_AUTH_TOKEN`	No	-	Shared bearer token required on every HTTP/SSE request. Minimum 16 characters. Unset means no authentication.
`PIHOLE_HTTP_AUTH_TOKEN_FILE`	No	-	Path to a file holding the bearer token, so it stays out of `ps`. Mutually exclusive with `PIHOLE_HTTP_AUTH_TOKEN`.
`PIHOLE_RATE_LIMIT`	No	`120`	Requests per minute per MCP session on the HTTP/SSE transports, under a per-address ceiling of four times that. Clients on MCP revision `2026-07-28` send no session, so only the ceiling applies to them. `0` disables.
`PIHOLE_ALLOWED_ORIGINS`	No	`localhost,127.0.0.1,[::1]`	Comma-separated Origin/Host allowlist for HTTP/SSE transports. The literal `*` disables enforcement (unsafe). Not authentication.
`PIHOLE_TRUSTED_PROXIES`	No	-	Comma-separated IPs or CIDR blocks whose `X-Forwarded-For` the rate limiter believes. Unset means the header is ignored.
`PIHOLE_BACKUP_DIR`	No	-	Absolute path of an existing directory to keep teleporter backups in. When set, `pihole_teleporter_export` writes only inside it and `pihole_teleporter_import` reads only from it, and the server never removes anything there. Unset, backups go to the system temp directory by default, where the server removes its own after a day, and any absolute path is accepted.
`PIHOLE_TLS_SKIP_VERIFY`	No	`false`	Disable TLS certificate verification for Pi-hole connections. Only for instances serving self-signed certificates. A trusted certificate is preferable where possible.
`TZ`	No	System timezone (UTC in Docker)	IANA timezone for rendered timestamps (e.g. `Australia/Adelaide`). Timezone data is embedded in the binary, so this works in the Docker image out of the box.
`OTEL_EXPORTER_OTLP_ENDPOINT`	No	-	OpenTelemetry collector endpoint. Setting it enables tracing; ignored in slim builds.

Application passwords are recommended for automation: they bypass TOTP 2FA and can be revoked independently.

PIHOLE_HTTP_AUTH_TOKEN, PIHOLE_HTTP_AUTH_TOKEN_FILE, PIHOLE_RATE_LIMIT, PIHOLE_ALLOWED_ORIGINS and PIHOLE_TRUSTED_PROXIES only apply to the http and sse transports; stdio is a single-process, single-user channel by definition and isn't gated. See Security before exposing either transport beyond loopback.

Scoping the tool surface

By default the server offers every tool, including 34 that change Pi-hole and 27 that are destructive. Two variables narrow that.

PIHOLE_READ_ONLY=true exposes only tools that cannot change anything, on Pi-hole or on the host the server runs on, so it leaves out pihole_teleporter_export, which writes a file. Write tools are absent from tools/list and rejected if called anyway, so a client working from a cached listing cannot reach one either.

PIHOLE_READ_ONLY=true    # 48 tools instead of 82

PIHOLE_TOOLSETS selects which families of tools exist at all, which is worth doing on its own because tools/list is a cost paid in every conversation:

PIHOLE_TOOLSETS=dashboard,domains,lists    # blocklist curation, and nothing else

PIHOLE_TOOLSETS=all # the default, stated explicitly

The two intersect, and read-only always wins. PIHOLE_READ_ONLY=true with PIHOLE_TOOLSETS=dns,stats gives the 14 tools that are in those toolsets *and* read-only.

The toolset names, what each contains and how many tools it holds are in docs/TOOLS.md, generated from the same table the server filters with. An unknown name fails at startup and lists every valid one; run pihole-mcp -check to see it, along with how many tools your configuration actually exposes:

scope: read-only=true, toolsets=dns,stats  14 of 82 tools exposed

A published toolset name is never removed, renamed or narrowed. See CONTRIBUTING.md for the full promise.

Multiple instances

To manage more than one Pi-hole, configure numbered instances instead of PIHOLE_URL/PIHOLE_PASSWORD:

Variable	Required	Description
`PIHOLE_1_URL`, `PIHOLE_2_URL`, …	Yes	Base URL of each instance (contiguous from 1)
`PIHOLE_1_PASSWORD`, `PIHOLE_2_PASSWORD`, …	Yes	Password for the matching instance

| PIHOLE_1_NAME, PIHOLE_2_NAME, … | No | Fri

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Pi-hole MCP Server

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

Dialyne

README vom Entwickler

pihole-mcp

Why this one

Quick Start

What you can ask

Installation

MCP Registry

Homebrew

Scoop (Windows)

Go Install

Docker

Linux Packages

Fedora / RHEL / CentOS

Binary Download

Check your setup

Configuration

Scoping the tool surface

Multiple instances