MCP server for Pi-hole v6 API — manage multiple instances: queries, lists, groups, stats
npx -y @ranklancer/pihole-mcp{
"PIHOLE_INSTANCES": "YOUR_VALUE_HERE",
"PIHOLE_BASE_URL": "YOUR_VALUE_HERE",
"PIHOLE_PASSWORD": "YOUR_SECRET_VALUE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-ranklancer-pihole-mcp": {
"command": "npx",
"args": [
"-y",
"@ranklancer/pihole-mcp"
],
"env": {
"PIHOLE_INSTANCES": "YOUR_VALUE_HERE",
"PIHOLE_BASE_URL": "YOUR_VALUE_HERE",
"PIHOLE_PASSWORD": "YOUR_SECRET_VALUE"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
Pi-hole MCP Server is an MCP server for MCP server for Pi-hole v6 API — manage multiple instances: queries, lists, groups, stats. It supports STDIO transport.
Use the generated config in Install. This server runs with npx -y @ranklancer/pihole-mcp; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for npx -y @ranklancer/pihole-mcp. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for npx -y @ranklancer/pihole-mcp. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for npx -y @ranklancer/pihole-mcp. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for npx -y @ranklancer/pihole-mcp. Add required environment variables before starting Cursor or VS Code.
Pi-hole MCP Server uses STDIO transport. Use the package or command config in Install.
Pi-hole MCP Server inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
Pi-hole MCP Server is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
@ranklancer/pihole-mcpstdio | npm | 0.2.0 | Env: PIHOLE_INSTANCES required Env: PIHOLE_BASE_URL required Env: PIHOLE_PASSWORD required secret |