← Index

Pi-hole MCP Server

io.github.ranklancer/pihole-mcp·v0.2.0·Other
Quality Score
85
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "pihole-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ranklancer/pihole-mcp"
      ],
      "env": {
        "PIHOLE_INSTANCES": "<pihole_instances>",
        "PIHOLE_BASE_URL": "<pihole_base_url>",
        "PIHOLE_PASSWORD": "<your-pihole_password>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "pihole-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ranklancer/pihole-mcp"
      ],
      "env": {
        "PIHOLE_INSTANCES": "<pihole_instances>",
        "PIHOLE_BASE_URL": "<pihole_base_url>",
        "PIHOLE_PASSWORD": "<your-pihole_password>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @ranklancer/pihole-mcp
§02  Environment variables
PIHOLE_INSTANCES
required

Comma-separated list of Pi-hole instance names (e.g. 'pihole' or 'primary,secondary')

PIHOLE_BASE_URL
required

Base URL of your first Pi-hole instance (e.g. 'http://192.168.1.100')

PIHOLE_PASSWORD
requiredsecret

API password for your first Pi-hole instance

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
15
installability
25
documentation
15
stability
5
§04  Alternatives in Other