# notify-mcp

An MCP server that sends native Windows desktop notifications with repeating sound alerts for [Claude Code](https://docs.anthropic.com/en/docs/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](screenshot/done-notification.png) | ![Needs Help](screenshot/need-help-notification.png) | ![Pending Review](screenshot/pending-review-notification.png) |

## Setup

```bash
npm install
npm run build
```

### Add to Claude Code (global)

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

Or manually add to `~/.claude.json`:

```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