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

Related MCP server: Suzu (鈴) - Claude Code Notification Server

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