# Notification Hook

> The event when Claude Code needs you, used for desktop or phone pings.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Notification, permission_prompt, idle_prompt

## Think of it like

It is like a phone that buzzes you when the oven is done.

## Definition

Notification is the hook event that fires when Claude Code sends a notice. Common kinds are permission_prompt, when Claude needs your yes, and idle_prompt, when it is waiting for you. The matcher picks the kind. It is the usual way to get a desktop or phone ping. Its exit code and output are ignored.

## Example

Emma leaves Claude working and makes tea. Her Notification hook pings her laptop when Claude needs a yes.

## Example code

```json
{
  "hooks": {
    "Notification": [
      { "matcher": "permission_prompt|idle_prompt", "hooks": [{ "type": "command", "command": "notify-send 'Claude needs you'" }] }
    ]
  }
}
```

A desktop ping when Claude waits on you.

## Why it matters

Claude can sit waiting for an hour while you are away. A ping ends that wait.

## Common mistake

Expecting an instant ping on each prompt. Some kinds only fire after you seem away for a few seconds.

## Three principles

- **When it needs you.** Prompts, idle.
- **Match the kind.** permission_prompt.
- **Output ignored.** Pings only.

## Related terms

- [PermissionRequest Hook](https://learn.benibix.com/term/ai/permissionrequest-hook)
- [StopFailure Hook](https://learn.benibix.com/term/ai/stopfailure-hook)
- [Claude Code Hook](https://learn.benibix.com/term/ai/claude-code-hook)

---

Source: https://learn.benibix.com/term/ai/notification-hook
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
