Pi-hole MCP Server

Overview

Pi-hole MCP Server integrates Pi-hole v6 directly into your AI assistant workflow. It exposes DNS blocking, domain management, client tracking, query analysis, DHCP configuration, and multi-instance synchronization as tools your AI can invoke, turning your network security appliance into an intelligent agent that understands and responds to your network's needs.

The server runs locally via Docker using the image ghcr.io/hexamatic/pihole-mcp:0.8.1, communicating with your AI assistant over stdio. You'll need to provide PIHOLE_URL and PIHOLE_PASSWORD as environment variables to authenticate with your Pi-hole instance. Version 0.8.1 is released under the MIT license, with source code available at hexamatic/pihole-mcp on GitHub.

Pi-hole MCP Server belongs in the AI & Agents category on mcp.site and works with MCP clients including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Zed, and others. If you maintain this server for hexamatic, claim this listing to verify ownership and keep the information up to date.

Installation

// claude_desktop_config.json
{
  "mcpServers": {
    "pi_hole_mcp_server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hexamatic/pihole-mcp:0.8.1"
      ],
      "env": {
        "PIHOLE_URL": "<pihole-url>",
        "PIHOLE_PASSWORD": "<pihole-password>"
      }
    }
  }
}

Requires PIHOLE_URL, PIHOLE_PASSWORD