Claude Tips mascot
Claude Tips & Tricks
Claude Code beginner

Get Desktop Notifications When Claude Needs Input

Set up hooks to send a desktop notification when Claude finishes a task or needs your approval, so you can work on other things.

When Claude is working on a long task, you don’t need to watch the terminal. Set up a notification hook so you know the moment it needs you.

macOS Setup

Add this to .claude/settings.json:

{
  "hooks": {
    "notification": [
      {
        "event": "stop",
        "command": "osascript -e 'display notification \"Claude needs your input\" with title \"Claude Code\"'"
      }
    ]
  }
}

Linux Setup

{
  "hooks": {
    "notification": [
      {
        "event": "stop",
        "command": "notify-send 'Claude Code' 'Claude needs your input'"
      }
    ]
  }
}

Add Sound

On macOS, play a sound when Claude stops:

{
  "event": "stop",
  "command": "afplay /System/Library/Sounds/Glass.aiff"
}

When to Use

  • Running 3+ Claude sessions across tmux panes
  • Kicked off a long refactor and switched to another task
  • Waiting for Claude to finish tests before reviewing results

This pairs well with auto-accept permissions. Let Claude handle reads and safe operations automatically, then get notified only when it’s done or blocked.