Pi-hole MCP Server MCP Server

io.github.hexamatic/pihole-mcp

Repository Registry

What is the Pi-hole MCP Server MCP server?

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

How to install Pi-hole MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PIHOLE_URL
required
Base URL of your Pi-hole web interface. For multiple Pi-holes use PIHOLE_1_URL, PIHOLE_2_URL, ... instead.
PIHOLE_PASSWORD
required
secret
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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pihole-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hexamatic/pihole-mcp:0.9.0"
      ],
      "env": {
        "PIHOLE_URL": "<YOUR_PIHOLE_URL>",
        "PIHOLE_PASSWORD": "<YOUR_PIHOLE_PASSWORD>",
        "TZ": "<YOUR_TZ>",
        "PIHOLE_READ_ONLY": "<YOUR_PIHOLE_READ_ONLY>",
        "PIHOLE_TLS_SKIP_VERIFY": "<YOUR_PIHOLE_TLS_SKIP_VERIFY>",
        "PIHOLE_REQUEST_TIMEOUT": "<YOUR_PIHOLE_REQUEST_TIMEOUT>",
        "PIHOLE_MAX_RETRIES": "<YOUR_PIHOLE_MAX_RETRIES>",
        "PIHOLE_RETRY_MAX_DELAY": "<YOUR_PIHOLE_RETRY_MAX_DELAY>"
      }
    }
  }
}

Related MCP servers

xSkill AI

AI content generation with 50+ models: image, video, TTS, voice cloning, and more.

View repository →

HEY Research Lab

Active

Evidence-backed Robinhood Chain research: builders, ships, contracts, changes, market context.

TypeScript

MIT

View repository →

Spin Wheel Names

Spin a random picker wheel, pick a random number, and search shared wheels from spinwheelnames.com.

View repository →

Rafi

Manage authorized Rafi leads, reminders, DNC status, and AI voice playbooks.

HeySale — AI Website Salesperson

Active

Create and install an AI Website Salesperson for sales, qualification, and lead capture.

Python

Apache-2.0

View repository →

io.github.hezeclark/devkits

12 local developer tools: JSON, Base64, JWT, regex, hash, UUID, Markdown, diff, cron.

View repository →