Loading
Pi Hole MCP Server
io.github.hexamaticClaim this server
Power your agent
Add this server
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
Local command
docker run -i --rm ghcr.io/hexamatic/pihole-mcp:0.10.0Credentials from the publisher
- PIHOLE_URL — Base URL of your Pi-hole web interface. For multiple Pi-holes use PIHOLE_1_URL, PIHOLE_2_URL, ... instead.
- PIHOLE_PASSWORD — Pi-hole admin password, or an application password (recommended — bypasses TOTP 2FA)
- TZ — IANA timezone for rendered timestamps, e.g. Australia/Adelaide. Defaults to UTC in the container.
- PIHOLE_READ_ONLY — Expose only inspection tools. Every tool that can change Pi-hole is hidden and rejected if called.
- PIHOLE_TLS_SKIP_VERIFY — Set to true only for a Pi-hole serving a self-signed HTTPS certificate. A trusted certificate is the better fix.
- PIHOLE_REQUEST_TIMEOUT — HTTP request timeout as a Go duration, e.g. 30s or 1m
- PIHOLE_MAX_RETRIES — Retries after a transient Pi-hole API failure; 0 disables retrying
- PIHOLE_RETRY_MAX_DELAY — Upper bound on a single exponential-backoff wait, as a Go duration
Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
shClaude Code
PIHOLE_URL=<value> PIHOLE_PASSWORD=<secret> TZ=<value> PIHOLE_READ_ONLY=<value> PIHOLE_TLS_SKIP_VERIFY=<value> PIHOLE_REQUEST_TIMEOUT=<value> PIHOLE_MAX_RETRIES=<value> PIHOLE_RETRY_MAX_DELAY=<value> claude mcp add io.github.hexamatic-pihole-mcp -- docker run -i --rm ghcr.io/hexamatic/pihole-mcp:0.10.0Run in a terminal.
jsonClaude Desktop
{ "mcpServers": { "io.github.hexamatic-pihole-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/hexamatic/pihole-mcp:0.10.0" ], "env": { "PIHOLE_URL": "<value>", "PIHOLE_PASSWORD": "<secret>", "TZ": "<value>", "PIHOLE_READ_ONLY": "<value>", "PIHOLE_TLS_SKIP_VERIFY": "<value>", "PIHOLE_REQUEST_TIMEOUT": "<value>", "PIHOLE_MAX_RETRIES": "<value>", "PIHOLE_RETRY_MAX_DELAY": "<value>" } } }}claude_desktop_config.json
Local · ociPublisher installStep-by-step: add this in Claude
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
Host a copy with our keys and logs.
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchServer facts
Local- Transport
- stdio
Tools
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ