Pi-hole MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 28 installs a week from npm. Last commit 19 Oct 2026.
MCP server for Pi-hole v6 API — manage multiple instances: queries, lists, groups, stats
Nothing serious here today
Today is the operative word: we check Pi-hole MCP Server every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add pihole-mcp -e 'PIHOLE_INSTANCES=<PIHOLE_INSTANCES>' -e 'PIHOLE_BASE_URL=<PIHOLE_BASE_URL>' -e 'PIHOLE_PASSWORD=<PIHOLE_PASSWORD>' -- npx -y @ranklancer/pihole-mcp{
"mcpServers": {
"pihole-mcp": {
"command": "npx",
"args": [
"-y",
"@ranklancer/pihole-mcp"
],
"env": {
"PIHOLE_BASE_URL": "<PIHOLE_BASE_URL>",
"PIHOLE_INSTANCES": "<PIHOLE_INSTANCES>",
"PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
}
}
}
}[mcp_servers.pihole-mcp]
command = "npx"
args = ["-y", "@ranklancer/pihole-mcp"]
env = { PIHOLE_INSTANCES = "<PIHOLE_INSTANCES>", PIHOLE_BASE_URL = "<PIHOLE_BASE_URL>", PIHOLE_PASSWORD = "<PIHOLE_PASSWORD>" }{
"mcpServers": {
"pihole-mcp": {
"command": "npx",
"args": [
"-y",
"@ranklancer/pihole-mcp"
],
"env": {
"PIHOLE_BASE_URL": "<PIHOLE_BASE_URL>",
"PIHOLE_INSTANCES": "<PIHOLE_INSTANCES>",
"PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
}
}
}
}{
"servers": {
"pihole-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ranklancer/pihole-mcp"
],
"env": {
"PIHOLE_BASE_URL": "<PIHOLE_BASE_URL>",
"PIHOLE_INSTANCES": "<PIHOLE_INSTANCES>",
"PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
}
}
}
}Put your own values in place of
<PIHOLE_INSTANCES> (Comma-separated list of Pi-hole instance names (e.g. 'pihole' or 'primary,secondary')), <PIHOLE_BASE_URL> (Base URL of your first Pi-hole instance (e.g. 'http://192.168.1.100')), <PIHOLE_PASSWORD> (API password for your first Pi-hole instance).
The author’s registry entry marks them as required.
Alternatives to Pi-hole MCP Server
same job, measured the same wayManage Pi-hole v6: DNS blocking, domains, clients, query analysis, DHCP, and multi-instance sync.
Pi-hole v6 MCP server - manage DNS blocking, stats, whitelists/blacklists
MCP server for VK Ads (VK Реклама) API: manage ad plans, ad groups, banners, and statistics.
MCP server for Pi-hole: status, stats, blocking toggle. Works with any instance.
MCP server for checking package versions across multiple package managers
MCP server for Neo4j Aura Database Instance Manager.
MCP server for xyzDB: run xyTalk queries, inspect lobes and stats, take hot snapshots.
MCP server for Instagram Graph API, Threads API & Meta platform management
Pi-hole MCP Server — questions
Answers built from our own checks of this server.