Pi-Hole MCP – a local MCP is up and running with Claude Code

Pi-Hole MCP – gives AI assistants full control over your Pi-hole instance DNS blocking domain management query analysis statistics network devices DHCP and system administration compatible with the Pi-hole v6 REST API

root@pve-pihole-mcp-01:~#
root@pve-pihole-mcp-01:~# mkdir -p MCP
root@pve-pihole-mcp-01:~# cd MCP
root@pve-pihole-mcp-01:~/MCP# curl -LO https://github.com/hexamatic/pihole-mcp/releases/download/v0.10.0/pihole-mcp_0.10.0_linux_amd64.deb
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 –:–:– –:–:– –:–:– 0
100 7102k 100 7102k 0 0 7193k 0 –:–:– –:–:– –:–:– 12.0M
root@pve-pihole-mcp-01:~/MCP# ls -la
total 7112
drwxr-xr-x 2 root root 4096 Nov 13 11:13 .
drwx—— 5 root root 4096 Nov 13 10:48 ..
-rw-r–r– 1 root root 7272568 Nov 13 11:13 pihole-mcp_0.10.0_linux_amd64.deb
root@pve-pihole-mcp-01:~/MCP#
root@pve-pihole-mcp-01:~/MCP# apt-get install ./pihole-mcp_0.10.0_linux_amd64.deb
Reading package lists… Done
Building dependency tree… Done
Reading state information… Done
Note, selecting ‚pihole-mcp‘ instead of ‚./pihole-mcp_0.10.0_linux_amd64.deb‘
The following NEW packages will be installed:
pihole-mcp
0 upgraded, 1 newly installed, 0 to remove and 2 not upgraded.
Need to get 0 B/7273 kB of archives.
After this operation, 18.9 MB of additional disk space will be used.
Get:1 /root/MCP/pihole-mcp_0.10.0_linux_amd64.deb pihole-mcp amd64 0.10.0 [7273 kB]
Selecting previously unselected package pihole-mcp.
(Reading database … 17470 files and directories currently installed.)
Preparing to unpack …/pihole-mcp_0.10.0_linux_amd64.deb …
Unpacking pihole-mcp (0.10.0) …
Setting up pihole-mcp (0.10.0) …
N: Download is performed unsandboxed as root as file ‚/root/MCP/pihole-mcp_0.10.0_linux_amd64.deb‘ couldn’t be accessed by user ‚_apt‘. – pkgAcquire::Run (13: Permission denied)
root@pve-pihole-mcp-01:~/MCP#
root@pve-pihole-mcp-01:~/MCP# which pihole-mcp
/usr/local/bin/pihole-mcp
root@pve-pihole-mcp-01:~/MCP#
root@pve-pihole-mcp-01:~/MCP# PIHOLE_URL=http://192.168.1.182 PIHOLE_PASSWORD=<password> pihole-mcp -check
pihole-mcp 0.10.0
scope: read-only=false, toolsets=all 82 of 82 tools exposed
PASS primary (http://192.168.1.182) core v6.5, FTL v6.8
All 1 instance(s) reachable and authenticated.
root@pve-pihole-mcp-01:~/MCP#

Start ‚pihole-mcp‘ in local HTTP Mode …

root@ra-ai-01:~# PIHOLE_RATE_LIMIT=0 PIHOLE_URL=“http://192.168.1.182″ PIHOLE_PASSWORD=“<Application Password>“ pihole-mcp -transport http -address 127.0.0.1:8080
2026/11/16 17:12:13 starting *server.StreamableHTTPServer on 127.0.0.1:8080 (auth=none, rate-limit=0/min, allowed-origins=[localhost 127.0.0.1 [::1]], trusted-proxies=[])

… and use it with Claude Code

root@ra-ai-01:~# claude mcp add –transport http pihole-mcp http://127.0.0.1:8080/mcp
root@ra-ai-01:~# claude mcp get pihole-mcp
pihole-mcp:
Scope: Local config (private to you in this project)
Status: ✔ Connected
Type: http
URL: http://127.0.0.1:8080/mcp
To remove this server, run: claude mcp remove pihole-mcp -s local
root@ra-ai-01:~#

Leave a Reply

You must be logged in to post a comment.