README

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

Finished	Needs Help	Pending Review

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

notify-mcp

README

notify-mcp

Features

Screenshots

Setup

Add to Claude Code (global)

Usage

Requirements

License

Recommended Servers