notifier-mcp

A tiny MCP server for desktop notifications and strong alerts across platforms.

Features

• Sends cross-platform weak reminders / toast-style desktop notifications using node-notifier
• Sends strong acknowledgement-focused alerts on Windows and macOS
• Exposes two MCP tools:
  • send_notification
  • send_strong_alert
• Runs over stdio

Install

cd notifier-mcp
npm install

Published usage:

npx -y notifier-mcp

Requirements:

• Node.js >= 18

If npx -y notifier-mcp fails after an upgrade or republish, clear the local npm cache once and retry:

npm cache clean --force
npx -y notifier-mcp

Run

npm start

Tools

send_notification

Send a cross-platform desktop notification using node-notifier.

Parameters:

• title: string
• message: string
• async?: boolean, default true
• wait?: boolean
• sound?: boolean
• timeout?: number (1-60)
• open?: string
• appID?: string

Behavior:

• async: true: returns immediately after triggering the notification
• async: false: waits for the library callback, which may vary by platform and does not necessarily mean user acknowledgement

Best for weak reminders / toast-style alerts on Windows, macOS, and supported Linux environments.

send_strong_alert

Send a foreground, acknowledgement-focused alert.

Supported platforms:

• Windows: uses PowerShell + WinForms
• macOS: uses osascript

Parameters:

• title: string
• message: string
• buttonText?: string
• async?: boolean, default true

Behavior:

• async: true: triggers the alert and returns immediately
• async: false: waits until the alert is acknowledged by the user

Notes:

• On macOS, the button text is not customized in this implementation; it uses the default OK button.
• On unsupported platforms, use send_notification instead.

Example MCP client config

Use the command:

{
  "command": "npx",
  "args": ["-y", "notifier-mcp"]
}