What does PiHole MCP Server do?
It acts as a bridge between AI applications and a Pi-hole instance, exposing tools to manage DNS blocking, domain lists, and retrieve statistics.
PiHole MCP Server
@JafarKhQ
Basic information
About PiHole MCP Server
Manage Pi-hole with the power of AI
PiHole MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"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_app_password"
}
}
}
}PiHole MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is PiHole MCP Server?
PiHole MCP Server is a Java-based MCP (Model Context Protocol) server that enables AI applications to manage a Pi-hole instance through standard commands. It is designed for users who want to control Pi-hole DNS blocking, domain lists, and retrieve statistics from an AI assistant.
How to use PiHole MCP Server?
Ensure Java 21 is installed, download the JAR from the releases page, and configure your AI client with the server command (java -jar /path/to/pihole-mcp.jar) and environment variables (PIHOLE_HOST, PIHOLE_APP_PASSWORD, and optionally PIHOLE_PORT). Then, restart the client to make the tools available.
Key features of PiHole MCP Server
- Restart the Pi-hole FTL DNS service.
- Get or set DNS blocking status with optional disable timer.
- Add domains to allowlist or denylist (exact or regex).
- Retrieve Pi-hole statistics (total queries, blocked, top domains).
- Fetch system information (CPU, memory, blocking percentage, uptime).
Use cases of PiHole MCP Server
- Enable or disable Pi-hole ad blocking from an AI chat interface.
- Automatically add suspicious domains to the denylist via AI workflow.
- Monitor Pi-hole performance and query statistics in real time.
- Quickly restart the FTL service when troubleshooting network issues.
Frequently asked questions
What are the system requirements?
Java 21 must be installed on the machine running the server. The Pi-hole instance must be reachable over the network.
How do I connect it to my Pi-hole?
Set the environment variables `PIHOLE_HOST` (IP or hostname), `PIHOLE_APP_PASSWORD` (your Pi-hole application password), and optionally `PIHOLE_PORT` (default 80).
Does it support authentication?
Yes, it uses the Pi-hole application password provided via the `PIHOLE_APP_PASSWORD` environment variable.
What commands can the AI send?
The server exposes six tools: restart FTL, get/set blocking status, add a domain, retrieve statistics, and retrieve system information.
More Other MCP servers
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
14.8K
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
Handl
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Comments