MCP server

Pi-hole MCP Server

io.github.hexamatic/pihole-mcp

Checked 26 Oct 2026, 08:31 UTC · Checked against OSV.dev for malware and vulnerabilities; never run by us

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Runs on your computer

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code

Last checked

26 Oct 2026, 08:31 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. It then runs the package on your computer with your permissions. For other apps, copy the setup below.

Claude Code

claude mcp add pihole-mcp --env PIHOLE_URL=YOUR_VALUE --env PIHOLE_PASSWORD=YOUR_VALUE -- docker run -i --rm -e PIHOLE_URL -e PIHOLE_PASSWORD ghcr.io/hexamatic/pihole-mcp:0.9.0

Claude Desktop

{"mcpServers":{"pihole-mcp":{"command":"docker","args":["run","-i","--rm","-e","PIHOLE_URL","-e","PIHOLE_PASSWORD","ghcr.io/hexamatic/pihole-mcp:0.9.0"],"env":{"PIHOLE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

Codex (config.toml)

[mcp_servers.pihole-mcp]
command = "docker"
args = ["run","-i","--rm","-e","PIHOLE_URL","-e","PIHOLE_PASSWORD","ghcr.io/hexamatic/pihole-mcp:0.9.0"]
env = { PIHOLE_URL = "YOUR_VALUE", PIHOLE_PASSWORD = "YOUR_VALUE" }

Gemini CLI

{"mcpServers":{"pihole-mcp":{"command":"docker","args":["run","-i","--rm","-e","PIHOLE_URL","-e","PIHOLE_PASSWORD","ghcr.io/hexamatic/pihole-mcp:0.9.0"],"env":{"PIHOLE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

Cursor

{"mcpServers":{"pihole-mcp":{"command":"docker","args":["run","-i","--rm","-e","PIHOLE_URL","-e","PIHOLE_PASSWORD","ghcr.io/hexamatic/pihole-mcp:0.9.0"],"env":{"PIHOLE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

VS Code

{"servers":{"pihole-mcp":{"type":"stdio","command":"docker","args":["run","-i","--rm","-e","PIHOLE_URL","-e","PIHOLE_PASSWORD","ghcr.io/hexamatic/pihole-mcp:0.9.0"],"env":{"PIHOLE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

Runs on your computer with your permissions: check the package and its source before installing. Replace YOUR_VALUE with your own PIHOLE_URL, PIHOLE_PASSWORD.

Browse

• GitHub tools
• Domains and DNS
• GitHub and code hosting

Related MCP servers

• TunnelMind Data API
  Tracker / Sigil / Cross-lens — every TunnelMind Data API operation as one MCP surface.
• Planner MCP — provable "done" for AI agents
  Goal and task planning MCP for Codex and AI agents, with evidence-backed completion.
• Kernelcad
  Agent-first CAD: editable .kcad.ts source, deterministic review, OpenCASCADE kernel.
• Stymie Golf
  Read-only US golf course, scorecard, equipment, deal, and golf-trip data for AI agents.
• Fredenslund workshop tools
  MFT/3 hole patterns (Shaper-ready SVG) and French cleat wall plans with cut lists. Free, unofficial.
• 3D Printer on Demand
  Quote, check and order 3D prints of STL, 3MF, STEP or OBJ files. Made in the USA, shipped in the US.
• Bucky
  Zoning, parcel, and development feasibility for a street address in Canada and the US.
• Awning
  Find and book local services, classes and rentals; businesses set up and manage their pages.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.hexamatic/pihole-mcp.svg)](https://aptlynx.net/servers/io.github.hexamatic/pihole-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents