🍓 pihole-mcp-serer
About
A Model Context Protocol (MCP) server for Pi-hole
Details
- Author
- sbarbett
- GitHub stars
- 8
- Downloads
- 371
- Categories
- Other, AI
Jump to
- Manage local DNS A and CNAME records
- Query recent DNS query history
- Get query filter suggestions
- Retrieve activity graph data over time
- Support up to four Pi-hole instances
- Deploy with Docker for easy production use
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🍓 pihole-mcp-sererCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Create a .env file with PIHOLE_URL and PIHOLE_PASSWORD (and optionally up to three additional Pi-holes). Run the server via Docker (docker-compose up -d) for production or with uv run mcp dev main.py for development. Then configure an MCP client (e.g., Goose or Claude Desktop) to connect to the SSE endpoint at http://localhost:8383/sse.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83c\udf53 pihole-mcp-serer": {
"pihole-mcp-server": {
"command": "uv",
"args": [
"run",
"mcp",
"dev",
"main.py"
]
}
}
}
}McpServers
{
"pihole-mcp-server": {
"command": "uv",
"args": [
"run",
"mcp",
"dev",
"main.py"
]
}
}🍓 pihole-mcp-serer
A Model Context Protocol (MCP) server for Pi-hole. This server exposes Pi-hole functionality as tools that can be used by AI assistants.
Dependencies
Docker
uv (Optional, for Development)
If you want to run the application locally, use uv. Install it with your package manager of choice.
Environment
Create a .env file in the project root with your Pi-hole credentials:
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
