Pi-hole MCP Server

An MCP (Model Context Protocol) server that gives AI assistants like Claude full control over your Pi-hole v6 DNS ad-blocker - query logs, allow/deny lists, group management, gravity reload, and stats. Designed from day one for multi-instance deployments: manage one or many Pi-hole instances from a single MCP endpoint. It runs locally over stdio via the published package.

People connecting cloud infrastructure tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-22 · ★ 2 · #72 OF 141 MAINTAINED CLOUD INFRASTRUCTURE · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Pi-hole MCP Server

before you install - you'll need

Set PIHOLE_INSTANCES, PIHOLE_BASE_URL, PIHOLE_PASSWORD, PRIMARY_BASE_URL, PRIMARY_PASSWORD, SECONDARY_BASE_URL, SECONDARY_PASSWORD, SECONDARY_INSECURE_TLS before connecting.

Claude Code

claude mcp add ranklancer-pihole-mcp -- npx -y @ranklancer/pihole-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ranklancer-pihole-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ranklancer/pihole-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @ranklancer/pihole-mcp - published under the repo owner's npm scope (@ranklancer)

registry namespace io.github.ranklancer is GitHub-verified and matches the repo owner

03 · Who maintains Pi-hole MCP Server

Pi-hole MCP Server is maintained by ranklancer. It's the only MCP server we track from this author; the repo dates to Apr 2026.

04 · Facts

repository: github.com/ranklancer/pihole-mcp
category: cloud infrastructure - ranked #72 of 141 actively-maintained cloud infrastructure servers as of 2026-08-25.
registry: io.github.ranklancer/pihole-mcp (active, first published 2026-04-12)
packages: npm:@ranklancer/pihole-mcp

05 · Pi-hole MCP Server FAQ

What is Pi-hole MCP Server?

Is Pi-hole MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-22. We re-verify nightly.

How do I install Pi-hole MCP Server?

Run `npx -y @ranklancer/pihole-mcp`. The README documents 8 environment variables (PIHOLE_INSTANCES, PIHOLE_BASE_URL, PIHOLE_PASSWORD…) to set first. Set PIHOLE_INSTANCES, PIHOLE_BASE_URL, PIHOLE_PASSWORD, PRIMARY_BASE_URL, PRIMARY_PASSWORD, SECONDARY_BASE_URL, SECONDARY_PASSWORD, SECONDARY_INSECURE_TLS before connecting. You can also paste the ready-made client config above.

Does Pi-hole MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

06 · Alternatives to Pi-hole MCP Server

Alternatives to Pi-hole MCP Server

Maintained cloud infrastructure servers if Pi-hole MCP Server isn't the fit.

Pairs well with

Servers that cover what Pi-hole MCP Server doesn't - only shown when the pairing reason fits the companion.

More cloud infrastructure MCP servers · Vnsh · Transcriptor MCP · Ocm MCP Server · Seaworthy Io MCP Server · Latex MCP

More TypeScript MCP servers · Remnus · Perplexity Comet MCP · N8n MCP · Mindmap MCP Server · see all