MCP server

Pi-hole MCP Server

io.github.ranklancer/pihole-mcp

Checked 26 Oct 2026, 08:31 UTC · Still published on its registry; checked against OSV.dev; never run by us

MCP server for Pi-hole v6 API — manage multiple instances: queries, lists, groups, stats

Runs on your computer

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 Cursor Add to VS Code VS 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_INSTANCES=YOUR_VALUE --env PIHOLE_BASE_URL=YOUR_VALUE --env PIHOLE_PASSWORD=YOUR_VALUE -- npx -y @ranklancer/pihole-mcp@0.2.0

Claude Desktop

{"mcpServers":{"pihole-mcp":{"command":"npx","args":["-y","@ranklancer/pihole-mcp@0.2.0"],"env":{"PIHOLE_INSTANCES":"YOUR_VALUE","PIHOLE_BASE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

Codex (config.toml)

[mcp_servers.pihole-mcp]
command = "npx"
args = ["-y","@ranklancer/pihole-mcp@0.2.0"]
env = { PIHOLE_INSTANCES = "YOUR_VALUE", PIHOLE_BASE_URL = "YOUR_VALUE", PIHOLE_PASSWORD = "YOUR_VALUE" }

Gemini CLI

{"mcpServers":{"pihole-mcp":{"command":"npx","args":["-y","@ranklancer/pihole-mcp@0.2.0"],"env":{"PIHOLE_INSTANCES":"YOUR_VALUE","PIHOLE_BASE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

Cursor

{"mcpServers":{"pihole-mcp":{"command":"npx","args":["-y","@ranklancer/pihole-mcp@0.2.0"],"env":{"PIHOLE_INSTANCES":"YOUR_VALUE","PIHOLE_BASE_URL":"YOUR_VALUE","PIHOLE_PASSWORD":"YOUR_VALUE"}}}}

VS Code

{"servers":{"pihole-mcp":{"type":"stdio","command":"npx","args":["-y","@ranklancer/pihole-mcp@0.2.0"],"env":{"PIHOLE_INSTANCES":"YOUR_VALUE","PIHOLE_BASE_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_INSTANCES, PIHOLE_BASE_URL, PIHOLE_PASSWORD.

Browse

Related MCP servers

Googleapis
Create, manage, and query your Google Cloud SQL resources.
Googleapis
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Exoscale MCP by usefulapi
Inspect Exoscale: instances, volumes, SKS, DNS, IPs, quotas and usage; start, stop, reboot VMs.
ElevenLabs
ElevenLabs in natural language: generate speech in any language, create and manage voices, compose m
Googleapis
Provides tools to manage Memorystore for Valkey instances and backups.
Zammad MCP by usefulapi
Search and read Zammad tickets, customers and organizations; add notes, replies and ticket updates.
AMIRA — Africa Multiple Research Data
Read-only access to AMIRA, the Africa Multiple research-data platform on Omeka S.
Exchange Rates
Convert currencies, get FX rates, and query historical Frankfurter v1 exchange rate data.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.ranklancer/pihole-mcp.svg)](https://aptlynx.net/servers/io.github.ranklancer/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