MCP serverCommunity

Pi-hole MCP Server

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

hexamatic · ↓ 0 installs

Install

Add the config to your client settings. Replace values in <angle brackets> with your own.

claude_desktop_config.json

{
  "mcpServers": {
    "pihole-mcp": {
      "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": "<PIHOLE_URL>",
        "PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>",
        "TZ": "<TZ>",
        "PIHOLE_READ_ONLY": "false",
        "PIHOLE_TLS_SKIP_VERIFY": "false",
        "PIHOLE_REQUEST_TIMEOUT": "30s",
        "PIHOLE_MAX_RETRIES": "3",
        "PIHOLE_RETRY_MAX_DELAY": "8s"
      }
    }
  }
}

Or in one command — the CLI adds the server to your client config:

CLI

npx ai-point add io.github.hexamatic/pihole-mcp

Tools

The tool list will appear once the server has a sandbox or the editors fill it in.

Report a problem ↗ (Opens GitHub in a new tab)