Leina 
Wanta 
Investigate a Domain
Read DNS queries and search allow, block and gravity lists for a domain.
/oo Pi-hole: Read queries for [domain], search its list membership and explain the returned blocking context.
Connect Pi-hole to Your AI Agent
Use AI with Pi-hole to inspect DNS logs, understand blocked domains and apply an explicit blocking setting.
40 tools API key
Try a Pi-hole Task
Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.
oo Skill Pi-hole
Review DNS Activity
Read overview and upstream metrics to summarize DNS activity.
/oo Pi-hole: Get Pi-hole overview and upstream metrics, then summarize query activity and response times.
Set Timed Blocking
Change blocking mode for an explicit duration and check its status.
/oo Pi-hole: Disable DNS blocking for [seconds], then read the current blocking status.
Start Working with Pi-hole
-
Install OOMOL
Set up oo CLI and the oo Skill in your agent.
Install OOMOL → -
Connect Pi-hole
Provide a Pi-hole application password and a publicly reachable instance URL.
Connect Pi-hole → -
Give Your Agent a Task
Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →
Choose Your Agent
- A public Pi-hole instance reachable by the hosted connector, with an application password.
- Private or local network addresses are not reachable. Specify the domain or query period; timer-based blocking changes automatically revert to the opposite mode.
Pi-hole Tools
Use AI with Pi-hole to inspect DNS logs, understand blocked domains and apply an explicit blocking setting.
Investigate a Domain
Read DNS queries and search allow, block and gravity lists for a domain.
Review DNS Activity
Read overview and upstream metrics to summarize DNS activity.
Set Timed Blocking
Change blocking mode for an explicit duration and check its status.
40 tools
Get Overview
Fetch the Pi-hole activity overview: total and blocked queries, blocked query percentage, unique clients and domains, and the blocking and gravity list status.
pi_hole.get_overview Get Dns Blocking Status
Fetch whether Pi-hole DNS blocking is currently enabled, disabled, failed, or unknown.
pi_hole.get_dns_blocking_status Set Dns Blocking
Enable or disable Pi-hole DNS blocking, optionally for a limited time after which the opposite mode is restored automatically.
pi_hole.set_dns_blocking Get Queries
Query the Pi-hole DNS log with optional filters. By default returns the most recent queries; each response exposes a cursor for the next chunk.
pi_hole.get_queries Get Query Types
Fetch the number of queries of each DNS query type that Pi-hole has seen.
pi_hole.get_query_types Get Top Domains
Fetch the domains Pi-hole has handled the most, optionally limited to blocked ones.
pi_hole.get_top_domains Get Top Clients
Fetch the clients that have queried Pi-hole the most, optionally limited to blocked ones.
pi_hole.get_top_clients Get Recent Blocked
Fetch the domains most recently blocked by Pi-hole.
pi_hole.get_recent_blocked Get Upstreams
Fetch metrics about Pi-hole's DNS upstream destinations, including response times.
pi_hole.get_upstreams Get History
Fetch the Pi-hole activity graph data: query totals over time with cached, blocked, and forwarded splits.
pi_hole.get_history Search Domain
Search whether a domain appears in Pi-hole's allowlists, blocklists, or gravity lists, to understand why it is blocked or allowed.
pi_hole.search_domain Get Config
Fetch the current Pi-hole configuration, such as DNS settings, privacy level, and API settings.
pi_hole.get_config Update Config
Change part of the Pi-hole configuration, for example DNS upstreams, the privacy level, or API settings. The provided fields are merged into the current configuration.
pi_hole.update_config Run Gravity
Run the Pi-hole gravity update to refresh the blocklists. The instance streams the gravity log; the action reports a best-effort status from the log plus the tail of the stream.
pi_hole.run_gravity Restart Dns
Restart Pi-hole's DNS server and reload its DNS configuration.
pi_hole.restart_dns Flush Dns Logs
Flush the Pi-hole DNS query log.
pi_hole.flush_dns_logs List Groups
List all Pi-hole groups and their memberships.
pi_hole.list_groups Create Group
Create one or more Pi-hole groups, optionally with a comment and enabled state.
pi_hole.create_group Update Group
Update one Pi-hole group: rename it, or change its comment or enabled state.
pi_hole.update_group Delete Group
Delete one Pi-hole group by name.
pi_hole.delete_group List Lists
List the Pi-hole allowlists and blocklists (subscription lists).
pi_hole.list_lists Add List
Add one or more allowlist or blocklist entries (addresses) to Pi-hole.
pi_hole.add_list Update List
Update one Pi-hole list: change its comment, enabled state, or group memberships.
pi_hole.update_list Delete List
Delete one Pi-hole allowlist or blocklist entry by address.
pi_hole.delete_list List Domains
List the individual Pi-hole domain entries, optionally restricted to one type or kind.
pi_hole.list_domains Add Domain
Add one or more allow or deny domain entries to Pi-hole, either exact or as regular expressions.
pi_hole.add_domain Update Domain
Update one Pi-hole domain entry: change its comment, enabled state, or group memberships.
pi_hole.update_domain Delete Domain
Delete one Pi-hole allow or deny domain entry.
pi_hole.delete_domain List Clients
List all Pi-hole clients and their group memberships.
pi_hole.list_clients Create Client
Register one or more Pi-hole clients identified by IP address, MAC address, hostname, or interface.
pi_hole.create_client Update Client
Update one Pi-hole client's comment or group memberships.
pi_hole.update_client Delete Client
Delete one Pi-hole client entry by identifier.
pi_hole.delete_client Batch Delete Groups
Delete multiple Pi-hole groups by name in one request. Reports deleted=false when none of the groups exist.
pi_hole.batch_delete_groups Batch Delete Lists
Delete multiple Pi-hole allowlist or blocklist entries in one request. Reports deleted=false when none of the entries exist.
pi_hole.batch_delete_lists Batch Delete Domains
Delete multiple Pi-hole domain entries in one request. Reports deleted=false when none of the entries exist.
pi_hole.batch_delete_domains Batch Delete Clients
Delete multiple Pi-hole client entries in one request. Reports deleted=false when none of the clients exist.
pi_hole.batch_delete_clients Get Dhcp Leases
Fetch the currently active DHCP leases assigned by the Pi-hole DHCP server.
pi_hole.get_dhcp_leases Get Network Devices
Fetch the devices seen on the local network by Pi-hole.
pi_hole.get_network_devices Export Backup
Create a complete Pi-hole teleporter backup archive (teleporter.zip) with all settings, lists, and clients.
pi_hole.export_backup Import Backup
Restore a Pi-hole teleporter backup archive (a previously exported teleporter.zip) to this instance.
pi_hole.import_backup No matching tools.
Frequently Asked Questions
Can this connect to my LAN-only Pi-hole?
No. The hosted connector requires a publicly reachable instance URL and rejects private and local network targets.
How does the blocking timer behave?
After the supplied duration, Pi-hole restores the opposite blocking mode automatically.
What should I specify in my request?
Private or local network addresses are not reachable. Specify the domain or query period; timer-based blocking changes automatically revert to the opposite mode.