How do I connect Pihole MCP Server to Claude?

The listing records `go install github.com/hexamatic/pihole-mcp/cmd/pihole-mcp@latest` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, Cursor as compatible clients.

Is Pihole MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Pihole MCP Server do?

Pihole MCP Server documents 28 tools to the agent, including pihole_action_gravity_update, pihole_action_restart_dns, pihole_config_properties. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Pihole MCP

Unclaimed

by hexamatic

MCP server for Pi-hole v6 — DNS blocking, query analysis, and multi-instance management for AI assistants

Install

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

Set up this server

Compare servers My Stack

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions

aidnsdockergogolanghomelabllmmcpmcp-servermodel-context-protocolnetworkpi-holepihole

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

28 of 28 tools

Documented tools (28)

From project documentation. A server handshake does not verify each tool’s description or behavior.

pihole_action_gravity_update

Re-download blocklists

pihole_action_restart_dns

Restart FTL DNS resolver

pihole_config_properties

List read-only config keys (Pi-hole v6.6.1+)

pihole_dns_get_blocking

Get current DNS blocking status and timer

pihole_dns_set_blocking

Enable/disable blocking with optional timer

pihole_domains_add

Add domains (bulk supported)

pihole_domains_batch_delete

Remove multiple domains

pihole_domains_delete

Remove a domain

pihole_domains_list

List allow/deny domains

pihole_domains_update

Update domain entry

pihole_info_database

Database size and query count

pihole_info_dismiss_message

Dismiss a diagnostic message by ID

pihole_info_messages

FTL diagnostic messages

pihole_info_system

Host, CPU, memory, disk, load, temperature

pihole_info_version

Pi-hole component versions

pihole_instance_diff

Compare configuration between two instances

pihole_instance_sync

Reconcile a target instance towards a source (dry-run plan, then confirmed apply)

pihole_padd

One-call snapshot: queries, blocking, top domain/client, cache, versions, host health

pihole_queries_search

Search queries with 12 filters + cursor pagination

pihole_queries_suggestions

Available filter values

pihole_search_domains

Cross-list domain search

pihole_stats_database

Long-term database statistics

pihole_stats_query_types

Query type distribution (A, AAAA, MX, etc.)

pihole_stats_recent_blocked

Recently blocked domains

pihole_stats_summary

Queries, blocking rate, clients, gravity size

pihole_stats_top_clients

Most active clients by query count

pihole_stats_top_domains

Top queried or blocked domains

pihole_stats_upstreams

Upstream DNS server performance

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Pihole MCP Server

How do I connect Pihole MCP Server to Claude?: The listing records `go install github.com/hexamatic/pihole-mcp/cmd/pihole-mcp@latest` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, Cursor as compatible clients.
Is Pihole MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Pihole MCP Server do?: Pihole MCP Server documents 28 tools to the agent, including pihole_action_gravity_update, pihole_action_restart_dns, pihole_config_properties. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.