Is Pihole MCP Server safe to use?

Pihole MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Pihole MCP Server?

Pihole MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Pihole MCP Server do?

Pihole MCP Server provides 16 tools: pihole_get_stats, pihole_get_top_blocked, pihole_get_top_permitted, pihole_get_top_clients, pihole_get_query_log and 11 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Pihole MCP Server?

Pihole MCP Server is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio and http transport.

Is Pihole MCP Server actively maintained?

Pihole MCP Server is actively maintained — last commit was 9 days ago. It has 3 GitHub stars.

Pihole MCP Server

mcp-pihole-server

Pi-hole v6 MCP server - manage DNS blocking, stats, whitelists/blacklists

3 39/wk 16 tools GitHub npm

No known CVEs

No license

Actively maintained

Last commit 9d ago

Untested

Transport: stdio, http

16 tools · ~864 tok

Grade B · 0.4% of 200K ctx

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Untested on Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pihole": {
      "env": {
        "PIHOLE_URL": "http://your-pihole-address:8080",
        "PIHOLE_PASSWORD": "your-app-password"
      },
      "args": [
        "-y",
        "mcp-pihole-server"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-aplaceforallmystuff-mcp-pihole)](https://mcppedia.org/s/io-github-aplaceforallmystuff-mcp-pihole)

Read me

What Pihole MCP Server does

An MCP (Model Context Protocol) server that connects AI assistants like Claude to your Pi-hole network-wide ad blocker. Manage DNS blocking, view statistics, control whitelists/blacklists, and more through natural language.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'mcp-pihole-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mcp-pihole-server against OSV.dev.

Inventory

Tools (16)

Click any tool to inspect its schema.

~864 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Pihole MCP Server safe to use?: Pihole MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Pihole MCP Server?: Pihole MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Pihole MCP Server do?: Pihole MCP Server provides 16 tools: pihole_get_stats, pihole_get_top_blocked, pihole_get_top_permitted, pihole_get_top_clients, pihole_get_query_log and 11 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Pihole MCP Server?: Pihole MCP Server is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio and http transport.
Is Pihole MCP Server actively maintained?: Pihole MCP Server is actively maintained — last commit was 9 days ago. It has 3 GitHub stars.

Similar servers

Others in other

View all →

Pi Lean Ctx95

Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.

3.0k 6

io.github.asklokesh/loki-mode94

Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.

992 8

Sigmap94

97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server

531 6

Sunpeak93

App framework, testing framework, and inspector for MCP Apps.

193 1

MCP Security Weekly

Get CVE alerts and security updates for Pihole MCP Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Untested on Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pihole": {
      "env": {
        "PIHOLE_URL": "http://your-pihole-address:8080",
        "PIHOLE_PASSWORD": "your-app-password"
      },
      "args": [
        "-y",
        "mcp-pihole-server"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-aplaceforallmystuff-mcp-pihole)](https://mcppedia.org/s/io-github-aplaceforallmystuff-mcp-pihole)

Read me

What Pihole MCP Server does

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'mcp-pihole-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

MCP Pi-hole Server

Why Use This?

If you're running Pi-hole on your network, this MCP server lets you:

Monitor DNS traffic - View query statistics, top blocked domains, and client activity
Control blocking - Enable/disable Pi-hole blocking instantly or with a timer
Manage lists - Add or remove domains from whitelist and blacklist without opening the web UI
View query logs - See recent DNS queries with detailed information
Maintain your Pi-hole - Update gravity (blocklists) and flush DNS cache

Features

Category	Tools
Statistics	Query totals, blocking percentage, top domains, top clients
Blocking Control	Enable, disable (with optional timer), check status
Domain Lists	Whitelist/blacklist CRUD operations
Query Log	Recent DNS queries with client, status, response time
Maintenance	Update gravity, flush cache
Visualizations	ASCII art dashboards and bar charts with ANSI colors

Prerequisites

Node.js 18+
Pi-hole v6 with API enabled
Pi-hole app password (generated in Pi-hole settings)
Network access to Pi-hole from your machine

Installation

Option 1: Install from npm (recommended)

npx mcp-pihole-server

Or install globally:

npm install -g mcp-pihole-server

Option 2: Clone and Build

git clone https://github.com/aplaceforallmystuff/mcp-pihole.git
cd mcp-pihole
npm install
npm run build

Configuration

1. Get Your Pi-hole App Password

Open your Pi-hole web interface
Go to Settings > API
Generate a new app password
Copy the password (it's only shown once)

2. Configure Your MCP Client

For Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pihole": {
      "command": "npx",
      "args": ["-y", "mcp-pihole-server"],
      "env": {
        "PIHOLE_URL": "http://your-pihole-address:8080",
        "PIHOLE_PASSWORD": "your-app-password"
      }
    }
  }
}

For Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "pihole": {
      "command": "npx",
      "args": ["-y", "mcp-pihole-server"],
      "env": {
        "PIHOLE_URL": "http://your-pihole-address:8080",
        "PIHOLE_PASSWORD": "your-app-password"
      }
    }
  }
}

Environment Variables

Variable	Description	Example
`PIHOLE_URL`	Pi-hole web interface URL	`http://pihole.local:8080`
`PIHOLE_PASSWORD`	Pi-hole app password	Your app password from settings

Usage Examples

Once configured, you can interact with Pi-hole through natural language:

View Statistics

"Show me Pi-hole stats"

"What are the top blocked domains?"

"Which clients are making the most queries?"

Control Blocking

"Is Pi-hole blocking enabled?"

"Disable Pi-hole for 5 minutes"

"Re-enable Pi-hole blocking"

Manage Domain Lists

"Add example.com to the whitelist"

"Block ads.trackersite.com"

"Show me

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mcp-pihole-server against OSV.dev.

Inventory

Tools (16)

Click any tool to inspect its schema.

~864 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Pihole MCP Server safe to use?: Pihole MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Pihole MCP Server?: Pihole MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Pihole MCP Server do?: Pihole MCP Server provides 16 tools: pihole_get_stats, pihole_get_top_blocked, pihole_get_top_permitted, pihole_get_top_clients, pihole_get_query_log and 11 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Pihole MCP Server?: Pihole MCP Server is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio and http transport.
Is Pihole MCP Server actively maintained?: Pihole MCP Server is actively maintained — last commit was 9 days ago. It has 3 GitHub stars.

Similar servers

Others in other

View all →

Pi Lean Ctx95

Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.

3.0k 6

io.github.asklokesh/loki-mode94

Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.

992 8

Sigmap94

97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server

531 6

Sunpeak93

App framework, testing framework, and inspector for MCP Apps.

193 1

MCP Security Weekly

Get CVE alerts and security updates for Pihole MCP Server and similar servers.