pihole-mcp

MCP server for Pi-hole: status, stats, blocking toggle. Works with any instance.

latest

Source

npm

Version: 1.0.1

Version published: 20 hours ago

Maintainers: 1

Created: 7 days ago

Source

Pi-hole MCP

MCP server for Pi-hole: status, stats, blocking toggle. Works with any instance (v6 API).

Setup

Use your web password (or an app password from Settings > Web interface):

export PIHOLE_URL=http://localhost
export PIHOLE_PASSWORD=secret
npm install
npm run build
node dist/index.js

The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.

Tools at a glance

status: Blocking state plus 24h stats.
set_blocking: Toggle with optional auto re-enable timer.

Limits and privacy

This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. Credentials stay local and go only to your Pi-hole.

Premium tools

These tools need a license key:

blocklist_audit
rule_match_test

Buy a key at https://mcp-marketplace.io/server/io-github-mrfentmen-pihole-mcp and set it in your MCP client config:

"env": { "MCP_LICENSE_KEY": "mcp_live_..." }

The key is checked against MCP Marketplace, cached for 24 hours, and keeps working offline once one check has succeeded. Every other tool on this server stays free.