notify-mcp

An MCP server that sends native Windows desktop notifications with repeating sound alerts for Claude Code.

When Claude needs your attention — finished a task, needs help, or wants a review — it triggers a native Windows popup with a gentle repeating chime until you respond.

Features

• Native Windows popup — WinForms dialog, no browser needed
• Repeating sound — gentle system chime every 8 seconds until dismissed
• 3 notification states:
• needs_help — Claude is stuck and needs your input
• finished — task is complete
• pending_review — work is ready for your review
• 2 user actions:
• OK — stops sound and closes popup
• Remind me in X min — snooze with custom minutes, re-triggers automatically

Screenshots

Setup

npm install
npm run build

Add to Claude Code (global)

claude mcp add --scope user --transport stdio notify -- node /path/to/notify-mcp/build/index.js

Or manually add to ~/.claude.json:

{
  "mcpServers": {
    "notify": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/notify-mcp/build/index.js"]
    }
  }
}

Usage

Once configured, Claude Code can call the notify tool:

notify({ state: "finished", message: "PR is ready for your review!" })
notify({ state: "needs_help", message: "Can't resolve merge conflict in auth.ts" })
notify({ state: "pending_review", message: "Refactor complete — please check the diff" })

Requirements

• Windows 10/11
• Node.js 18+
• PowerShell (ships with Windows)

License

MIT