How do I use mcp-pihole?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-pihole add ads.example.com to the deny list" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-pihole

Q: Which integrations are available for this server?

Manage Pi-hole v6 blocklists, DNS blocking, domain allow/deny lists, and query diagnostics.

by obrien-matthew

Overview Schema Related Servers Score Discussions

Python

Remote

mcp-pihole

MCP server for Pi-hole v6. Manage blocklists, DNS blocking, domain allow/deny lists, and query diagnostics through the Model Context Protocol.

Prerequisites

Python 3.14+
uv
Pi-hole v6+ with the REST API enabled

Related MCP server: pihole-mcp

Setup

uv sync

Configuration

Environment Variables

Variable	Required	Description
`PIHOLE_URL`	Yes	Base URL of your Pi-hole instance (e.g., `http://192.168.0.160:8080`)
`PIHOLE_PASSWORD`	No	Web interface password. Omit or leave empty for passwordless instances.

Claude Code

claude mcp add pihole \
  -e PIHOLE_URL=http://192.168.0.160:8080 \
  -e PIHOLE_PASSWORD=yourpassword \
  -- uvx mcp-pihole

Or add to .claude/settings.json:

{
  "mcpServers": {
    "pihole": {
      "command": "uvx",
      "args": ["mcp-pihole"],
      "env": {
        "PIHOLE_URL": "http://192.168.0.160:8080",
        "PIHOLE_PASSWORD": "yourpassword"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "pihole": {
      "command": "uvx",
      "args": ["mcp-pihole"],
      "env": {
        "PIHOLE_URL": "http://192.168.0.160:8080",
        "PIHOLE_PASSWORD": "yourpassword"
      }
    }
  }
}

Tools

Diagnostics

Tool	Description
`get_status`	Pi-hole status summary (queries, blocked count, blocking state)
`get_top_domains`	Top queried or blocked domains
`get_top_clients`	Top DNS clients by query count
`get_queries`	Recent DNS query log with cursor-based pagination
`get_version`	Pi-hole FTL version information

Blocklist Management

Tool	Description
`get_lists`	List all configured blocklists
`add_list`	Add a blocklist URL
`remove_list`	Remove a blocklist by URL
`update_list`	Enable/disable a blocklist or update its comment
`update_gravity`	Rebuild gravity database (required after blocklist changes)

Domain Management

Tool	Description
`get_domains`	List allow/deny domains (exact or regex)
`add_domain`	Add a domain to allow or deny list
`remove_domain`	Remove a domain from allow or deny list
`search_domains`	Check if a domain is blocked and by which list

DNS Control and DHCP

Tool	Description
`get_blocking_status`	Current DNS blocking status and timer
`set_blocking`	Enable/disable blocking, optionally with a timer
`get_dhcp_leases`	Current DHCP leases
`restart_dns`	Restart the DNS resolver

Development

uv sync
uv run pytest tests/ -x -q
uv run ruff check src/ tests/
uv run pyright src/

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/obrien-matthew/mcp-pihole'

If you have feedback or need assistance with the MCP directory API, please join our Discord server