PluginBench
MCP Server
Active
MIT

Pi-hole MCP Server MCP Server

io.github.hexamatic/pihole-mcp

RepositoryRegistry
How to choose

What this kind of tool is for

  • Automate a build, test, or deployment step you repeat by hand.
  • Review or refactor code in an existing repository without leaving your agent.
  • Bridge an internal service or CLI into the agent toolset.

How to compare servers like this

Scope of control:
Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
Environment fit:
Match the runtime it expects (Node, Python, a container) to what you actually run.
Maintenance signal:
Check the last-commit date — dev tooling that lags upstream breaks first.
Config surface:
Prefer tools whose environment-variable or config keys are documented plainly.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the Pi-hole MCP Server MCP server?

Manage Pi-hole v6: DNS blocking, domains, clients, query analysis, DHCP, and multi-instance sync.

How to install Pi-hole MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • PIHOLE_URL
    required

    Base URL of your Pi-hole web interface. For multiple Pi-holes use PIHOLE_1_URL, PIHOLE_2_URL, ... instead.

  • PIHOLE_PASSWORD
    required
    secret

    Pi-hole admin password, or an application password (recommended — bypasses TOTP 2FA)

  • TZ

    IANA timezone for rendered timestamps, e.g. Australia/Adelaide. Defaults to UTC in the container.

  • PIHOLE_READ_ONLY

    Expose only inspection tools. Every tool that can change Pi-hole is hidden and rejected if called.

  • PIHOLE_TLS_SKIP_VERIFY

    Set to true only for a Pi-hole serving a self-signed HTTPS certificate. A trusted certificate is the better fix.

  • PIHOLE_REQUEST_TIMEOUT

    HTTP request timeout as a Go duration, e.g. 30s or 1m

  • PIHOLE_MAX_RETRIES

    Retries after a transient Pi-hole API failure; 0 disables retrying

  • PIHOLE_RETRY_MAX_DELAY

    Upper bound on a single exponential-backoff wait, as a Go duration

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "pihole-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hexamatic/pihole-mcp:0.9.0"
      ],
      "env": {
        "PIHOLE_URL": "<YOUR_PIHOLE_URL>",
        "PIHOLE_PASSWORD": "<YOUR_PIHOLE_PASSWORD>",
        "TZ": "<YOUR_TZ>",
        "PIHOLE_READ_ONLY": "<YOUR_PIHOLE_READ_ONLY>",
        "PIHOLE_TLS_SKIP_VERIFY": "<YOUR_PIHOLE_TLS_SKIP_VERIFY>",
        "PIHOLE_REQUEST_TIMEOUT": "<YOUR_PIHOLE_REQUEST_TIMEOUT>",
        "PIHOLE_MAX_RETRIES": "<YOUR_PIHOLE_MAX_RETRIES>",
        "PIHOLE_RETRY_MAX_DELAY": "<YOUR_PIHOLE_RETRY_MAX_DELAY>"
      }
    }
  }
}

Related MCP servers

12 local developer tools: JSON, Base64, JWT, regex, hash, UUID, Markdown, diff, cron.

View repository →

Snapshot testing for AI agents—record behavior, catch regressions automatically.

128
Python
Apache-2.0
View repository →
FFFFMPEG API logo

FFMPEG API

Maintained

Hosted MCP tools for FFmpeg-style video and audio processing through FFMPEG API.

0
View repository →

Unified hub for managing multiple MCP servers with STDIO, HTTP, and SSE support.

27
TypeScript
MIT
View repository →

AI content generation with 50+ models: image, video, TTS, voice cloning, and more.

View repository →

Evidence-backed Robinhood Chain research: builders, ships, contracts, changes, market context.

0
TypeScript
MIT
View repository →