PiHole MCP Server

___ A Pi-hole MCP (Model Control Protocol) server implemented in Java that allows AI applications to interact with and manage a Pi-hole instance through standard commands.

Local serverstdio

What is the PiHole MCP Server?

PiHole MCP Server is an MCP project maintained in the jafarkhq/pihole-mcp-server repository. The maintainer describes its purpose as “___ A Pi-hole MCP (Model Control Protocol) server implemented in Java that allows AI applications to interact with and manage a Pi-hole instance through standard…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using java. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares PIHOLE_PORT, PIHOLE_HOST, PIHOLE_APP_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the PiHole MCP Server

{
  "mcpServers": {
    "pihole-mcp-server-java": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/pihole-mcp.jar"
      ],
      "env": {
        "PIHOLE_PORT": "8080",
        "PIHOLE_HOST": "192.168.1.2",
        "PIHOLE_APP_PASSWORD": "YOUR_PIHOLE_APP_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
PIHOLE_PORT	Declared in the maintainer’s client configuration.	Optional
PIHOLE_HOST	Declared in the maintainer’s client configuration.	Check documentation
PIHOLE_APP_PASSWORD	Declared in the maintainer’s client configuration.	Check documentation