HA-MCP Settings

Loading...
⚠ Changes saved. Restart ha-mcp for them to take effect — disabled tools will be fully removed from the MCP tool list on next startup.
Server-wide features (Tool Search, YAML config editing, filesystem tools, etc.) appear in both the Server Settings tab and the add-on Configuration page — they're the same settings either way. Either surface stays in sync with the other after the addon restart. Changes require an MCP-host restart to apply.
Pin toggles only take effect when Tool Search is enabled — either in the Server Settings tab or, for add-on users, the add-on Configuration page (same setting either way). Without Tool Search, all enabled tools are always visible and pinning has no extra effect.
Tool Search, beta-flagged features. Changes require an MCP-host restart to take effect (close + reopen Claude Desktop, restart the add-on, etc.).
Loading backup state…

Tool Security Policies

Per-tool approval gating for high-stakes calls. Use the Tools tab to enable gating for a tool, then refine the matching conditions and approval lifetime here. Condition operators: equals, is one of, regex, contains, is present, greater than, less than.

Global settings

Enable Tool Security Policies
Master switch. Mirrors the toggle in Server Settings. Off by default — toggle on and restart the addon to activate the gating middleware. While off, the rules below persist but aren't enforced.
Wait seconds (5-600)
How long the middleware waits for an approval before timing out.
Approval TTL minutes (1-60)
How long a pending approval stays in the queue before expiring.

Pending approvals

No pending approvals.

Gated tools