How do I connect MCP Pihole MCP Server to Claude?

Run `claude mcp add mcp-pihole -- npx -y mcp-pihole-server` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is MCP 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 MCP Pihole MCP Server do?

MCP Pihole MCP Server documents 16 tools to the agent, including pihole_add_to_blacklist, pihole_add_to_whitelist, pihole_disable_blocking. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

MCP Pihole

Unclaimed

by aplaceforallmystuff

MCP server for Pi-hole v6 API - control DNS blocking from Claude Code

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'mcp-pihole' -- 'npx' '-y' 'mcp-pihole-server'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

claudednshome-automationmcpmcp-servermodel-context-protocolnetwork-securitypihole

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

16 of 16 tools

Documented tools (16)

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

pihole_add_to_blacklist

Add domain to blacklist

pihole_add_to_whitelist

Add domain to whitelist

pihole_disable_blocking

Disable blocking (optionally with timer)

pihole_enable_blocking

Enable DNS blocking

pihole_flush_cache

Flush DNS cache

pihole_get_blacklist

List all blacklisted domains

pihole_get_blocking_status

Check if blocking is enabled

pihole_get_query_log

Get recent DNS queries

pihole_get_stats

Get comprehensive Pi-hole statistics

pihole_get_top_blocked

Get top blocked domains

pihole_get_top_clients

Get top clients by query count

pihole_get_top_permitted

Get top permitted domains

pihole_get_whitelist

List all whitelisted domains

pihole_remove_from_blacklist

Remove domain from blacklist

pihole_remove_from_whitelist

Remove domain from whitelist

pihole_update_gravity

Update blocklists (gravity)

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 MCP Pihole MCP Server

How do I connect MCP Pihole MCP Server to Claude?: Run `claude mcp add mcp-pihole -- npx -y mcp-pihole-server` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is MCP 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 MCP Pihole MCP Server do?: MCP Pihole MCP Server documents 16 tools to the agent, including pihole_add_to_blacklist, pihole_add_to_whitelist, pihole_disable_blocking. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.