Pi-hole MCP Server

latest · 0.2.0

MCP server for Pi-hole v6 API — manage multiple instances: queries, lists, groups, stats

GitHub: ranklancer/pihole-mcp
npm: @ranklancer/pihole-mcp
MCP registry: io.github.ranklancer/pihole-mcp

Install

Needs env vars: PIHOLE_INSTANCES, PIHOLE_BASE_URL, PIHOLE_PASSWORD — replace the <placeholders> with your values.

claude mcp add io-github-ranklancer-pihole-mcp --env PIHOLE_INSTANCES=<PIHOLE_INSTANCES> --env PIHOLE_BASE_URL=<PIHOLE_BASE_URL> --env PIHOLE_PASSWORD=<PIHOLE_PASSWORD> -- npx @ranklancer/pihole-mcp

/mcp confirms it's connected.

Install

Or add it manually in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "io-github-ranklancer-pihole-mcp": {
      "command": "npx",
      "args": [
        "@ranklancer/pihole-mcp"
      ],
      "env": {
        "PIHOLE_INSTANCES": "<PIHOLE_INSTANCES>",
        "PIHOLE_BASE_URL": "<PIHOLE_BASE_URL>",
        "PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
      }
    }
  }
}

In claude_desktop_config.json (Settings → Developer → Edit Config), then restart:

{
  "mcpServers": {
    "io-github-ranklancer-pihole-mcp": {
      "command": "npx",
      "args": [
        "@ranklancer/pihole-mcp"
      ],
      "env": {
        "PIHOLE_INSTANCES": "<PIHOLE_INSTANCES>",
        "PIHOLE_BASE_URL": "<PIHOLE_BASE_URL>",
        "PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
      }
    }
  }
}

Config entry, any MCP client:

{
  "command": "npx",
  "args": [
    "@ranklancer/pihole-mcp"
  ],
  "env": {
    "PIHOLE_INSTANCES": "<PIHOLE_INSTANCES>",
    "PIHOLE_BASE_URL": "<PIHOLE_BASE_URL>",
    "PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
  }
}

Community score

Community32/ 100

from web signals · no reviews yet (community v3)

Web signals (ecosystem baseline)32/100 · 100% of the weight

Used it? Rate v0.2.0

No reviews yet — be the first.

What the web says

Ecosystem baseline32/ 100

Objective public usage & activity (formula v3) — the community score's web-signals input, and its own sort.

GitHubsource ↗

GitHub stars · 4 days ago: ★ 2
Last commit · 4 days ago: 5 days ago
Issue close rate · 4 days ago: 0%
License · 4 days ago: MIT

Packages

No package-registry data collected yet.

Listed on

Glama · 2 days ago: Listed ↗

Mentions

No public discussion scraped yet.

Docs & liveness

No liveness or verification signals yet.

Version history1

0.2.0release date unknown

Badge for your README

Shows this page's community score and its sample, kept current, and links readers here to review.

[![rateme12 community score](https://api.rateme12.com/servers/939fe24d-0cf5-4e6a-9c58-69f4a3add5af/badge.svg)](https://rateme12.com/servers/939fe24d-0cf5-4e6a-9c58-69f4a3add5af)

Details

Transport: stdio
Status: listed
Source: Imported from the MCP registry
Repository: source ↗