auto_notify_if_appropriate

WHAT IT DOES

What auto_notify_if_appropriate does on Claude Code Notification Hooks

AI agents use auto_notify_if_appropriate to create or update resources in Claude Code Notification Hooks — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Claude Code Notification Hooks environment.

WHY IT NEEDS A POLICY

Why auto_notify_if_appropriate needs a policy

The tool writes notification events to the system but produces no permanent side effects beyond informing the user. It cannot delete data, execute arbitrary code, or commit financial transactions. While it modifies system state (adds notifications), this is reversible and non-destructive. Severity is low because misuse would only spam notifications rather than cause data loss or system compromise.

From the tool's definition Tool description states 'automatically send appropriate notifications' and 'send...notifications' - this creates (writes) notification state/records in the system notification queue without deleting or modifying existing data irreversibly.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

auto_notify_if_appropriate Rate-limited

auto_notify_if_appropriate stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "auto_notify_if_appropriate": {
      "limits": [
        {
          "counter": "auto_notify_if_appropriate_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches Claude Code Notification Hooks, so you can run agents against it safely.

FAQ

Questions about auto_notify_if_appropriate

What does the auto_notify_if_appropriate tool do? +

SMART AUTO-NOTIFICATION: Intelligently analyze context and automatically send appropriate notifications. Claude should use this proactively for: task completion detection, error analysis, user action evaluation, progress updates. This is the primary notification tool - use it frequently to keep users informed. It is categorised as a Write tool in the Claude Code Notification Hooks MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on auto_notify_if_appropriate? +

Register the Claude Code Notification Hooks MCP server in PolicyLayer and add a rule for auto_notify_if_appropriate: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Claude Code Notification Hooks. Nothing to install.

What risk level is auto_notify_if_appropriate? +

auto_notify_if_appropriate is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit auto_notify_if_appropriate? +

Yes. Add a rate_limit block to the auto_notify_if_appropriate rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block auto_notify_if_appropriate completely? +

Set action: deny in the PolicyLayer policy for auto_notify_if_appropriate. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides auto_notify_if_appropriate? +

auto_notify_if_appropriate is provided by the Claude Code Notification Hooks MCP server (nkyy/claude-code-notify-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.