mcp -desktop-notify

This MCP server exposes a cross-platform desktop notification capability that Claude can call to display notifications on your computer. Built on the notify-rust crate, it supports basic and advanced notification types across Linux, macOS, and Windows, including icons, custom timeouts, and urgency levels where available. The server provides a set of tools such as send_notification, send_urgent_notification, send_notification_with_icon, send_notification_with_timeout, and a fully customizable rich notification through send_rich_notification. To use it with Claude Desktop, configure Claude to connect to this MCP server as defined in your Claude config file, then invoke the available tools from Claude to display notifications on your machine.

Once configured, Claude can request a simple notification with a title and message, or opt into more advanced features like urgent/high-priority alerts, custom icons, timeouts, and rich options (including categories or app name where supported by the platform). The integration is designed to be straightforward: Claude sends a command with the desired parameters via MCP, and the server renders the notification on your desktop accordingly.

Prerequisites

• A supported operating system: Linux, macOS, or Windows
• Access to download the prebuilt binary from the project releases (or build from source if you prefer)
• Claude Desktop installed and configured to use MCP servers

Installation steps (downloaded binary)

1. Download the latest release binary for your platform from the repository releases page.
2. Make the binary executable (Linux/macOS):

   chmod +x mcp-server-desktop-notify
   

3. Move the binary to a directory in your PATH (optional but recommended):

   sudo mv mcp-server-desktop-notify /usr/local/bin/
   

4. Verify the binary runs (replace with your actual path if needed):

   /usr/local/bin/mcp-server-desktop-notify --help
   

5. Configure Claude Desktop to point to the MCP server using the provided configuration example in your Claude config file (see Configuration section in the README). Ensure the path you provide matches where you placed the binary.

If you prefer to build from source, follow the project’s build instructions in the repository (install Rust, cargo, and other dependencies), then compile the project and place the resulting binary in a PATH-accessible location.

Tips and considerations:

• Always use absolute paths in Claude configuration to avoid path resolution issues.
• On Windows, escape backslashes in JSON strings when specifying paths.
• Ensure the desktop notification binary is executable and has permission to display notifications on your OS.
• If notifications do not appear, verify that the terminal or process running the MCP server has the necessary permissions to create notifications on your desktop environment.
• Use the available tools (send_notification, send_urgent_notification, send_notification_with_icon, send_notification_with_timeout, send_rich_notification) to tailor the experience to your workflow. Some platform features (like icons or specific urgency levels) may vary by OS.