MCP Notify Server

A Model Context Protocol (MCP) server that provides system notification capabilities using node-notifier.

Tools

show-notification

Shows a system notification using the default notifier for the current platform.

Common parameters for all notification tools:

• title: Title of the notification
• message: Message content of the notification
• sound (optional): Play a sound with the notification (default: false)
• wait (optional): Wait for user action before removing notification (default: false)
• icon (optional): Path to icon file (.ico, .png, .jpg, or platform specific)
• timeout (optional): Time in seconds before notification expires (Linux/Windows)

show-notification-macos

Shows a notification using macOS Notification Center. Additional parameters:

• actions: Array of action button labels
• closeLabel: Label for closing notification
• dropdownLabel: Label for dropdown
• reply: Enable reply functionality

show-notification-linux

Shows a notification using Linux notify-send. Additional parameters:

• urgency: Notification urgency level (“low”, “normal”, “critical”)
• category: Category of notification
• hint: Hint for notification display
• app-name: Application name

show-notification-windows-toast

Shows a notification using Windows Toast notifications (Windows 8+). Additional parameters:

• appID: Application identifier
• shortcutPath: Path to shortcut file for notification
• install: Path to installer when notification is clicked

show-notification-windows-balloon

Shows a notification using Windows Balloon notifications (Windows 7 and earlier). Additional parameters:

• type: Notification type (“info”, “warn”, “error”)

show-notification-growl

Shows a notification using Growl. Additional parameters:

• name: Application name for Growl
• host: Growl server host
• port: Growl server port
• sticky: Keep notification visible
• label: Label for notification
• priority: Notification priority (-2 to 2)
• sender: Sender of notification

Development

1. Install dependencies:

npm install

2. Build the project:

npm run build

3. Start the server:

npm start

Usage with VS Code

For quick installation, use one of the one-click install buttons at the top of this README.

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

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