notify-mcp

0 starsMITCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Sends native Windows desktop notifications with repeating sound alerts for Claude Code, supporting states like finished, needs_help, and pending_review.

README.md

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 | |----------|------------|----------------| | !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" })