MCP Node-Notifier Server

MIT License
212
  • Linux
  • Apple

Integrations

  • Provides system notification capabilities for Linux systems using notify-send, supporting customizable urgency levels, categories, and display hints.

  • Enables system notifications through macOS Notification Center with support for action buttons, reply functionality, and customizable labels.

  • Allows installation and execution of the notification server through NPM packages, supporting one-click installation in VS Code environments.

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
  1. Build the project:
npm run build
  1. 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"] } } } }

Installing via Smithery

To install Notify Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @burkeholland/mcp-notify --client claude

Installing Manually

Add the MCP Notify server entry to your Claude settings to use it automatically.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that provides system notification capabilities across various platforms (macOS, Windows, Linux) using node-notifier.

  1. Tools
    1. show-notification
    2. show-notification-macos
    3. show-notification-linux
    4. show-notification-windows-toast
    5. show-notification-windows-balloon
    6. show-notification-growl
  2. Development
    1. Usage with VS Code
      1. Installing via Smithery
      2. Installing Manually

    Related MCP Servers

    • A
      security
      A
      license
      A
      quality
      A simple MCP server that can send notifications on mac devices.
      Last updated -
      5
      9
      8
      TypeScript
      MIT License
      • Apple
    • -
      security
      A
      license
      -
      quality
      A Model Context Protocol server enabling AI systems to send real-time notifications to phones, desktops, and other devices through the ntfy publish/subscribe service.
      Last updated -
      71
      4
      TypeScript
      Apache 2.0
      • Apple
    • -
      security
      A
      license
      -
      quality
      A Model Context Protocol server that provides network control and management capabilities through the POX SDN controller, enabling Python-based network programming, OpenFlow device management, and automated network analysis.
      Last updated -
      1
      Python
      MIT License
    • -
      security
      A
      license
      -
      quality
      A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
      Last updated -
      27
      TypeScript
      MIT License

    View all related MCP servers

    Appeared in Searches

    ID: 16ub4cuk2h