Pihole MCP Server

An MCP (Model Context Protocol) server that connects AI assistants like Claude to your Pi-hole network-wide ad blocker. Manage DNS blocking, view statistics, control whitelists/blacklists, and more through natural language. Its 16 documented tools cover pihole, top, blocking, whitelist. It runs locally over stdio via the published package.

People connecting security tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · ★ 7 · #69 OF 182 MAINTAINED SECURITY · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Pihole

before you install - you'll need

Set PIHOLE_URL, PIHOLE_PASSWORD before connecting.

Claude Code

claude mcp add aplaceforallmystuff-mcp-pihole -- npx -y mcp-pihole-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "aplaceforallmystuff-mcp-pihole": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-pihole-server"
      ]
    }
  }
}

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 mcp-pihole-server - unscoped; check the name against the project README before installing

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

03 · What Pihole can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get comprehensive Pi-hole statistics, get top blocked domains, get top permitted domains, and get top clients by query count.

The 16 tools it gives your agent

Extracted from the project's README - what mcp-pihole lets an agent do.

pihole_get_stats: - Get comprehensive Pi-hole statistics
pihole_get_top_blocked: - Get top blocked domains
pihole_get_top_permitted: - Get top permitted domains
pihole_get_top_clients: - Get top clients by query count
pihole_get_query_log: - Get recent DNS queries
pihole_get_blocking_status: - Check if blocking is enabled
pihole_enable_blocking: - Enable DNS blocking
pihole_disable_blocking: - Disable blocking (optionally with timer)
pihole_get_whitelist: - List all whitelisted domains
pihole_get_blacklist: - List all blacklisted domains
pihole_add_to_whitelist: - Add domain to whitelist
pihole_add_to_blacklist: - Add domain to blacklist

show all 16 tools

pihole_remove_from_whitelist: - Remove domain from whitelist
pihole_remove_from_blacklist: - Remove domain from blacklist
pihole_update_gravity: - Update blocklists (gravity)
pihole_flush_cache: - Flush DNS cache

04 · Who maintains Pihole

mcp-pihole is maintained by aplaceforallmystuff. We track 5 MCP servers from aplaceforallmystuff - 3 actively maintained, 220 combined GitHub stars, oldest repo from Nov 2025. Full record: all servers from aplaceforallmystuff.

05 · Facts

repository: github.com/aplaceforallmystuff/mcp-pihole
category: security - ranked #69 of 182 actively-maintained security servers as of 2026-08-25.
registry: io.github.aplaceforallmystuff/mcp-pihole (active, first published 2025-11-28)
packages: npm:mcp-pihole-server

06 · Pihole FAQ

Is Pihole still maintained?

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

What can Pihole do?

With this server connected, an agent can get comprehensive Pi-hole statistics, get top blocked domains, get top permitted domains, and get top clients by query count.

How do I install Pihole?

Run `npx -y mcp-pihole-server`. The README documents 2 environment variables (PIHOLE_URL, PIHOLE_PASSWORD) to set first. Set PIHOLE_URL, PIHOLE_PASSWORD before connecting. You can also paste the ready-made client config above.

Does Pihole 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.

07 · Alternatives to Pihole

Alternatives to Pihole

Maintained security servers if Pihole isn't the fit.

Pairs well with

Servers that cover what Pihole doesn't - only shown when the pairing reason fits the companion.

More security MCP servers · Threatintel · Apocdata MCP Server · Niro · Auth0 MCP Server · Server for OSCAL

More JavaScript MCP servers · AlloFlow Document Remediation · Appfigures · Claude KVM · Rosetta MCP Server · see all