{"slug": "claude-code-pushnotification-tool-what-it-does-and-how-to-use-it", "title": "Claude Code PushNotification tool: what it does and how to use it", "summary": "Claude Code now includes a native PushNotification tool that allows the AI assistant to send alerts to a user's phone or Claude app when long-running tasks complete or require attention. The tool is designed for background workflows, enabling Claude to notify users of state changes such as task completion, blocking issues, failures, or decisions needed, rather than routine progress updates.", "body_md": "**PushNotification** is a native Claude Code tool you can call to send PushNotification to your phone or Claude app.\n\nThe obvious use case is long-running tasks:\n\n\"Run the full test suite, fix what you can, and notify me using the PushNotification tool when the suite is green or blocked.\"\"\n\nBut the more interesting cases are background workflows:\n\nUseful examples:\n\nThis is especially useful with Monitor Tool, /loop, Crons.\n\n`/config`\n\nwith \"Push when Claude decides.\"On my Claude Code Always-on Agents (claude-code-hermit plugin), the notification policy is:\n\n`PushNotification`\n\n`PushNotification`\n\nas fallbackThat keeps the signal clean. Push should not duplicate every Discord/Telegram message. It should cover the cases where the normal path is absent, broken, or too slow.\n\nKeep the message short:\n\nCI failed on api-tests: 3 auth regressions. Open session for details.\n\nPut the actionable bit first:\n\nDecision needed: choose migration strategy before Claude edits schema.\n\nDo not push for routine progress. Push for state changes: done, blocked, failed, needs decision.\n\nIf you need to answer Claude, use Remote Control or a two-way channel. Push only gets your attention.\n\nTools reference: [https://code.claude.com/docs/en/tools-reference](https://code.claude.com/docs/en/tools-reference)\n\nMy take: `PushNotification`\n\nis a small tool, but it changes the workflow. Claude Code no longer has to sit silently in a terminal while you periodically check whether it finished. It can now tap you when the work is done, blocked, or worth opening again.", "url": "https://wpnews.pro/news/claude-code-pushnotification-tool-what-it-does-and-how-to-use-it", "canonical_source": "https://dev.to/gtapps/claude-code-pushnotification-tool-what-it-does-and-how-to-use-it-29p6", "published_at": "2026-06-05 22:21:02+00:00", "updated_at": "2026-06-05 22:41:17.707261+00:00", "lang": "en", "topics": ["ai-tools", "ai-agents", "ai-products", "artificial-intelligence", "large-language-models"], "entities": ["Claude Code", "PushNotification", "Monitor Tool", "Claude", "Discord", "Telegram", "Remote Control", "claude-code-hermit"], "alternates": {"html": "https://wpnews.pro/news/claude-code-pushnotification-tool-what-it-does-and-how-to-use-it", "markdown": "https://wpnews.pro/news/claude-code-pushnotification-tool-what-it-does-and-how-to-use-it.md", "text": "https://wpnews.pro/news/claude-code-pushnotification-tool-what-it-does-and-how-to-use-it.txt", "jsonld": "https://wpnews.pro/news/claude-code-pushnotification-tool-what-it-does-and-how-to-use-it.jsonld"}}