Pi-hole MCP Server

Name: Pi-hole MCP Server
Author: hexamatic

제작자: hexamatic버전 0.10.0i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.hexamatic/pihole-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

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

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 기타
입력해야 할 값: PIHOLE_URL, PIHOLE_PASSWORD

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
직접 입력할 값: PIHOLE_URL, PIHOLE_PASSWORD, TZ, PIHOLE_READ_ONLY, PIHOLE_TLS_SKIP_VERIFY, PIHOLE_REQUEST_TIMEOUT, PIHOLE_MAX_RETRIES, PIHOLE_RETRY_MAX_DELAY

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

DockerDocker 설치

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "pihole": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PIHOLE_URL",
        "-e",
        "PIHOLE_PASSWORD",
        "-e",
        "TZ",
        "-e",
        "PIHOLE_READ_ONLY",
        "-e",
        "PIHOLE_TLS_SKIP_VERIFY",
        "-e",
        "PIHOLE_REQUEST_TIMEOUT",
        "-e",
        "PIHOLE_MAX_RETRIES",
        "-e",
        "PIHOLE_RETRY_MAX_DELAY",
        "ghcr.io/hexamatic/pihole-mcp:0.10.0"
      ],
      "env": {
        "PIHOLE_URL": "your-value",
        "PIHOLE_PASSWORD": "your-value",
        "TZ": "your-value",
        "PIHOLE_READ_ONLY": "your-value",
        "PIHOLE_TLS_SKIP_VERIFY": "your-value",
        "PIHOLE_REQUEST_TIMEOUT": "your-value",
        "PIHOLE_MAX_RETRIES": "your-value",
        "PIHOLE_RETRY_MAX_DELAY": "your-value"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add pihole --env PIHOLE_URL=your-value --env PIHOLE_PASSWORD=your-value --env TZ=your-value --env PIHOLE_READ_ONLY=your-value --env PIHOLE_TLS_SKIP_VERIFY=your-value --env PIHOLE_REQUEST_TIMEOUT=your-value --env PIHOLE_MAX_RETRIES=your-value --env PIHOLE_RETRY_MAX_DELAY=your-value -- docker run -i --rm -e PIHOLE_URL -e PIHOLE_PASSWORD -e TZ -e PIHOLE_READ_ONLY -e PIHOLE_TLS_SKIP_VERIFY -e PIHOLE_REQUEST_TIMEOUT -e PIHOLE_MAX_RETRIES -e PIHOLE_RETRY_MAX_DELAY ghcr.io/hexamatic/pihole-mcp:0.10.0

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "pihole": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PIHOLE_URL",
        "-e",
        "PIHOLE_PASSWORD",
        "-e",
        "TZ",
        "-e",
        "PIHOLE_READ_ONLY",
        "-e",
        "PIHOLE_TLS_SKIP_VERIFY",
        "-e",
        "PIHOLE_REQUEST_TIMEOUT",
        "-e",
        "PIHOLE_MAX_RETRIES",
        "-e",
        "PIHOLE_RETRY_MAX_DELAY",
        "ghcr.io/hexamatic/pihole-mcp:0.10.0"
      ],
      "env": {
        "PIHOLE_URL": "your-value",
        "PIHOLE_PASSWORD": "your-value",
        "TZ": "your-value",
        "PIHOLE_READ_ONLY": "your-value",
        "PIHOLE_TLS_SKIP_VERIFY": "your-value",
        "PIHOLE_REQUEST_TIMEOUT": "your-value",
        "PIHOLE_MAX_RETRIES": "your-value",
        "PIHOLE_RETRY_MAX_DELAY": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "pihole": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PIHOLE_URL",
        "-e",
        "PIHOLE_PASSWORD",
        "-e",
        "TZ",
        "-e",
        "PIHOLE_READ_ONLY",
        "-e",
        "PIHOLE_TLS_SKIP_VERIFY",
        "-e",
        "PIHOLE_REQUEST_TIMEOUT",
        "-e",
        "PIHOLE_MAX_RETRIES",
        "-e",
        "PIHOLE_RETRY_MAX_DELAY",
        "ghcr.io/hexamatic/pihole-mcp:0.10.0"
      ],
      "env": {
        "PIHOLE_URL": "your-value",
        "PIHOLE_PASSWORD": "your-value",
        "TZ": "your-value",
        "PIHOLE_READ_ONLY": "your-value",
        "PIHOLE_TLS_SKIP_VERIFY": "your-value",
        "PIHOLE_REQUEST_TIMEOUT": "your-value",
        "PIHOLE_MAX_RETRIES": "your-value",
        "PIHOLE_RETRY_MAX_DELAY": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

PIHOLE_URL 필수 env
Base URL of your Pi-hole web interface. For multiple Pi-holes use PIHOLE_1_URL, PIHOLE_2_URL, ... instead.
PIHOLE_PASSWORD 비밀 필수 env
Pi-hole admin password, or an application password (recommended — bypasses TOTP 2FA)
TZ env
IANA timezone for rendered timestamps, e.g. Australia/Adelaide. Defaults to UTC in the container.
PIHOLE_READ_ONLY env
Expose only inspection tools. Every tool that can change Pi-hole is hidden and rejected if called.
PIHOLE_TLS_SKIP_VERIFY env
Set to true only for a Pi-hole serving a self-signed HTTPS certificate. A trusted certificate is the better fix.
PIHOLE_REQUEST_TIMEOUT env
HTTP request timeout as a Go duration, e.g. 30s or 1m
PIHOLE_MAX_RETRIES env
Retries after a transient Pi-hole API failure; 0 disables retrying
PIHOLE_RETRY_MAX_DELAY env
Upper bound on a single exponential-backoff wait, as a Go duration

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 hexamatic 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 32708개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 32708개 중 86%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 32708개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Pi-hole MCP Server, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: PIHOLE_URL, PIHOLE_PASSWORD

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.10.0)은 5일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Docker도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, OpenTakeoff

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트

설치

Remote Desktop Commander

제작자: desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

클라우드에서 실행★ 211그저께 업데이트

설치

OpenTakeoff

제작자: Kentucky-ai

Construction takeoff for AI agents: load plans, set scale, measure, count, export with provenance.

내 컴퓨터에서 실행오늘 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

pihole-mcp

A production-grade MCP server for Pi-hole v6.

Gives AI assistants full control over your Pi-hole instance: DNS blocking, domain management, query analysis, statistics, network devices, DHCP, and system administration. Compatible with the Pi-hole v6 REST API.

Why this one

Run it locked down. PIHOLE_READ_ONLY=true exposes only the tools that cannot change anything, enforced on every call, not just the tool list a client happens to cache. PIHOLE_TOOLSETS narrows further to just the families you need, so a client asking "what can I use" gets a smaller, cheaper answer.
82 tools (84 once a second Pi-hole is configured) covering roughly 95% of the Pi-hole v6 REST API, including domains, lists, groups, clients, DHCP, network, the query log, configuration, local DNS records, teleporter backup and restore, and session management.
Multi-instance diff and sync. Compare two Pi-holes and see exactly what differs, or reconcile one onto the other with a dry-run plan and a confirm token before anything is written.
Releases are signed and attested, not just built. Every archive and container image carries a keyless cosign signature, an SPDX SBOM and SLSA build provenance, and SECURITY.md has the one-line command to check each.
Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/) as io.github.hexamatic/pihole-mcp, installable by name from any client that supports registry install.
Shipped nine releases in five months since launch, each with real release notes describing what changed and why, not a commit-hash dump.

Quick Start

Most MCP clients use the same configuration format. Add this to your client's config:

"mcpServers": { "pihole": { "command": "pihole-mcp", "env": { "PIHOLE_URL": "http://192.168.1.2", "PIHOLE_PASSWORD": "your-password" } } } }

Then install the binary via one of the methods below.

What you can ask

The whole point is natural language, not tool names. A few examples of what to actually type:

You ask	What runs
"Is Pi-hole blocking right now, and for how long?"	`pihole_dns_get_blocking`
"Pause blocking for 10 minutes, I need to test something."	`pihole_dns_set_blocking`
"Why is reddit.com blocked? Check every list it could be on."	`pihole_search_domains`
"What are the top blocked domains today, and does anything look like a false positive?"	`pihole_stats_recent_blocked`, the `review_top_blocked` prompt
"Point nas.home at 192.168.1.50."	`pihole_local_dns_add`
"Which of my blocklists haven't updated in 30+ days?"	`pihole_lists_list`
"Show me devices on the network Pi-hole doesn't recognise."	`pihole_network_devices`, the `audit_network` prompt
"Compare my two Pi-holes and tell me what's different."	`pihole_instance_diff`
"Back up my configuration before I change anything."	`pihole_teleporter_export`
"Which upstream resolver is slowest, and is it worth switching?"	`pihole_stats_upstreams`, the `upstream_health` prompt

Set PIHOLE_READ_ONLY=true first if you want to ask questions without any risk of something being changed. See Scoping the tool surface.

Installation

MCP Registry

pihole-mcp is listed in the official MCP Registry as:

io.github.hexamatic/pihole-mcp

Clients that support registry install can add it by that name and will prompt for PIHOLE_URL and PIHOLE_PASSWORD. The listing points at the ghcr.io image, so the client needs a working Docker.

Homebrew

brew install hexamatic/tap/pihole-mcp

Installs on both macOS and Linux (Homebrew on Linux). On macOS the cask clears the quarantine attribute during install, so the binary runs without a Gatekeeper prompt. From v0.10.0 the macOS binaries need macOS 13 Ventura or later; v0.9.0 is the last release that runs on macOS 12.

Scoop (Windows)

scoop bucket add hexamatic https://github.com/hexamatic/scoop-bucket

scoop install pihole-mcp

Go Install

go install github.com/hexamatic/pihole-mcp/cmd/pihole-mcp@latest

Docker

docker pull ghcr.io/hexamatic/pihole-mcp:latest

Linux Packages

.deb and .rpm packages for Debian-based (Ubuntu, Raspberry Pi OS) and RPM-based (Fedora, RHEL) distributions are available on the Releases page.

# Debian / Ubuntu / Raspberry Pi OS

sudo dpkg -i pihole-mcp_X.Y.Z_linux_amd64.deb

Fedora / RHEL / CentOS

sudo rpm -i pihole-mcp_X.Y.Z_linux_amd64.rpm

Binary Download

Pre-built binaries for Linux, macOS 13 or later, and Windows (amd64 and arm64) are available on the Releases page.

Releases are checksummed, signed with keyless cosign, and ship SPDX SBOMs and SLSA build provenance. See SECURITY.md for the verification commands.

Check your setup

Once installed and configured, run the server directly with -check. It loads the configuration, contacts every Pi-hole you have configured, and reports each one by name:

PIHOLE_URL=http://192.168.1.2 PIHOLE_PASSWORD=your-password pihole-mcp -check

pihole-mcp 0.10.0

PASS primary (http://192.168.1.2) core v6.5, FTL v6.8

All 1 instance(s) reachable and authenticated.

It exits non-zero if any instance fails, and prints what to change. It also warns when a Pi-hole runs an FTL release affected by published security advisories, naming the release that fixes them. Worth running before you wire the server into a client: most clients hide the server's output, so a bad URL or password looks the same as a server that never started.

Configuration

Variable	Required	Default	Description
`PIHOLE_URL`	Yes	-	Pi-hole base URL (e.g. `http://192.168.1.2`)
`PIHOLE_PASSWORD`	Yes	-	Admin password or application password
`PIHOLE_READ_ONLY`	No	`false`	Expose only tools that cannot change Pi-hole. See Scoping the tool surface.
`PIHOLE_TOOLSETS`	No	all	Comma-separated toolset names to expose, e.g. `dashboard,domains`. Unset or `all` exposes everything.
`PIHOLE_REQUEST_TIMEOUT`	No	`30s`	HTTP request timeout
`PIHOLE_MAX_RETRIES`	No	`3`	Retries after a failed Pi-hole API call. `0` disables.
`PIHOLE_RETRY_MAX_DELAY`	No	`8s`	Upper bound on a single backoff wait.
`PIHOLE_HTTP_AUTH_TOKEN`	No	-	Shared bearer token required on every HTTP/SSE request. Minimum 16 characters. Unset means no authentication.
`PIHOLE_HTTP_AUTH_TOKEN_FILE`	No	-	Path to a file holding the bearer token, so it stays out of `ps`. Mutually exclusive with `PIHOLE_HTTP_AUTH_TOKEN`.
`PIHOLE_RATE_LIMIT`	No	`120`	Requests per minute per MCP session on the HTTP/SSE transports, under a per-address ceiling of four times that. Clients on MCP revision `2026-07-28` send no session, so only the ceiling applies to them. `0` disables.
`PIHOLE_ALLOWED_ORIGINS`	No	`localhost,127.0.0.1,[::1]`	Comma-separated Origin/Host allowlist for HTTP/SSE transports. The literal `*` disables enforcement (unsafe). Not authentication.
`PIHOLE_TRUSTED_PROXIES`	No	-	Comma-separated IPs or CIDR blocks whose `X-Forwarded-For` the rate limiter believes. Unset means the header is ignored.
`PIHOLE_BACKUP_DIR`	No	-	Absolute path of an existing directory to keep teleporter backups in. When set, `pihole_teleporter_export` writes only inside it and `pihole_teleporter_import` reads only from it, and the server never removes anything there. Unset, backups go to the system temp directory by default, where the server removes its own after a day, and any absolute path is accepted.
`PIHOLE_TLS_SKIP_VERIFY`	No	`false`	Disable TLS certificate verification for Pi-hole connections. Only for instances serving self-signed certificates. A trusted certificate is preferable where possible.
`TZ`	No	System timezone (UTC in Docker)	IANA timezone for rendered timestamps (e.g. `Australia/Adelaide`). Timezone data is embedded in the binary, so this works in the Docker image out of the box.
`OTEL_EXPORTER_OTLP_ENDPOINT`	No	-	OpenTelemetry collector endpoint. Setting it enables tracing; ignored in slim builds.

Application passwords are recommended for automation: they bypass TOTP 2FA and can be revoked independently.

PIHOLE_HTTP_AUTH_TOKEN, PIHOLE_HTTP_AUTH_TOKEN_FILE, PIHOLE_RATE_LIMIT, PIHOLE_ALLOWED_ORIGINS and PIHOLE_TRUSTED_PROXIES only apply to the http and sse transports; stdio is a single-process, single-user channel by definition and isn't gated. See Security before exposing either transport beyond loopback.

Scoping the tool surface

By default the server offers every tool, including 34 that change Pi-hole and 27 that are destructive. Two variables narrow that.

PIHOLE_READ_ONLY=true exposes only tools that cannot change anything, on Pi-hole or on the host the server runs on, so it leaves out pihole_teleporter_export, which writes a file. Write tools are absent from tools/list and rejected if called anyway, so a client working from a cached listing cannot reach one either.

PIHOLE_READ_ONLY=true    # 48 tools instead of 82

PIHOLE_TOOLSETS selects which families of tools exist at all, which is worth doing on its own because tools/list is a cost paid in every conversation:

PIHOLE_TOOLSETS=dashboard,domains,lists    # blocklist curation, and nothing else

PIHOLE_TOOLSETS=all # the default, stated explicitly

The two intersect, and read-only always wins. PIHOLE_READ_ONLY=true with PIHOLE_TOOLSETS=dns,stats gives the 14 tools that are in those toolsets *and* read-only.

The toolset names, what each contains and how many tools it holds are in docs/TOOLS.md, generated from the same table the server filters with. An unknown name fails at startup and lists every valid one; run pihole-mcp -check to see it, along with how many tools your configuration actually exposes:

scope: read-only=true, toolsets=dns,stats  14 of 82 tools exposed

A published toolset name is never removed, renamed or narrowed. See CONTRIBUTING.md for the full promise.

Multiple instances

To manage more than one Pi-hole, configure numbered instances instead of PIHOLE_URL/PIHOLE_PASSWORD:

Variable	Required	Description
`PIHOLE_1_URL`, `PIHOLE_2_URL`, …	Yes	Base URL of each instance (contiguous from 1)
`PIHOLE_1_PASSWORD`, `PIHOLE_2_PASSWORD`, …	Yes	Password for the matching instance

| PIHOLE_1_NAME, PIHOLE_2_NAME, … | No | Fri

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

Pi-hole MCP Server

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

기타 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Spec Driven Development

Remote Desktop Commander

OpenTakeoff

제작자의 README

pihole-mcp

Why this one

Quick Start

What you can ask

Installation

MCP Registry

Homebrew

Scoop (Windows)

Go Install

Docker

Linux Packages

Fedora / RHEL / CentOS

Binary Download

Check your setup

Configuration

Scoping the tool surface

Multiple instances