Skip to main content
Glama
Desktop Notification MCP Server

Desktop Notification MCP Server

by GhostTypes

Desktop Notification MCP Server

A Model Context Protocol (MCP) server that enables AI agents to send cross-platform desktop notifications with priority levels, categories, and duration control.

Features

  • Cross-platform support (macOS, Windows, Linux)

  • Priority levels for urgency control

  • Category-based visual distinction

  • Configurable display duration

  • Optional notification sounds

  • Success/error status reporting

Related MCP server: MCPing

Installation

npm install
npm run build

Usage

With Claude Desktop

Add to your Claude Desktop configuration file:

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "desktop-notifications": {
      "command": "node",
      "args": [
        "/absolute/path/to/desktop-notification-mcp/dist/index.js"
      ]
    }
  }
}

Parameters

Parameter

Type

Default

Description

title

string

required

Notification title

message

string

required

Notification message body

sound

boolean

false

Enable notification sound

priority

string

"normal"

Priority level: "low", "normal", "high", "critical"

category

string

"task"

Category: "task", "error", "success", "progress", "question", "reminder"

duration

number

auto

Display duration in milliseconds (0 = persistent)

Priority Levels

  • low - Quick updates, 5 second timeout

  • normal - Standard notifications, 10 second timeout (default)

  • high - Important updates, 15 second timeout

  • critical - Critical alerts, persistent until dismissed

Categories

  • task - General task notifications

  • error - Error and failure notifications

  • success - Success and completion notifications

  • progress - Progress updates

  • question - Questions requiring user attention

  • reminder - Reminders and scheduled notifications

Examples

Basic Notification

{
  "title": "Task Complete",
  "message": "Your analysis has finished"
}

High Priority Error

{
  "title": "Build Failed",
  "message": "Tests failed - review errors in output",
  "priority": "high",
  "category": "error",
  "sound": true
}

Critical Alert (Persistent)

{
  "title": "User Input Required",
  "message": "Please review the following options",
  "priority": "critical",
  "category": "question",
  "sound": true
}

Progress Update

{
  "title": "Processing...",
  "message": "Step 3 of 10 complete",
  "priority": "low",
  "category": "progress",
  "duration": 3000
}

Success Notification

{
  "title": "Deployment Complete",
  "message": "Successfully deployed to production",
  "priority": "normal",
  "category": "success",
  "sound": true
}

Platform Support

The server automatically detects and uses the appropriate notification system:

  • macOS 10.8+: Notification Center

  • Windows 8+: Toast Notifications

  • Windows < 8: Taskbar Balloons

  • Linux: notify-send (requires libnotify-bin)

Platform-Specific Behavior

Linux: Priority maps to urgency parameter (low/normal/critical), duration controls timeout precisely

Windows/macOS: Priority and category shown via visual indicators, timeout behavior varies by OS version

Linux Requirements

Install notification support:

# Ubuntu/Debian
sudo apt-get install libnotify-bin

# Fedora
sudo dnf install libnotify

# Arch
sudo pacman -S libnotify

Available Tools

1 tool
send-notificationSend Desktop NotificationB

Display a cross-platform desktop notification with title, message, priority, category, duration control, and optional sound

Inputs: title (required), message (required), sound, category, +2 more. Returns: error, success

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 1 tool

    Disambiguation5/5

    There is only one tool, so there is no possibility of confusing it with another tool. Its purpose—sending a desktop notification—is completely unambiguous.

    Naming Consistency5/5

    The single tool uses a clear, readable kebab-case verb-noun pattern (send-notification). With only one tool, there are no competing conventions to create inconsistency.

    Tool Count3/5

    A server whose sole purpose is desktop notifications is reasonably scoped with one tool, since sending a notification is the only meaningful operation. However, a single-tool server is inherently limited and feels thin compared to typical multi-tool MCP servers.

    Completeness4/5

    The tool covers the core notification lifecycle operation with title, message, priority, category, duration, and sound options. There are no obvious missing CRUD operations for a one-way notification service, though features like listing or dismissing notifications could be considered minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to send native macOS notifications for task completion alerts and reminders. Supports interactive features like custom system sounds, action buttons, and user replies directly from the notification center.
      201 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to send desktop notifications on macOS with rich formatting, urgency levels, and sound options.
      1
      11 npm
      1
      MIT
    • A
      license
      D
      quality
      D
      maintenance
      Enables MCP agents to send desktop notifications for completed tasks, failures, and important updates, providing visible and reliable feedback.
      1
      54 npm
      2
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI development tools on Windows to send native system notifications for task completion, errors, and reminders, with customizable icons and sounds.
      7
      20 npm
      8
      MIT