Notification MCP Server

How to use

To use the MCP Notify Server with an MCP client, configure a local or remote MCP server that runs the notifier and trigger it when a task finishes. You can start the notifier in a few ways and then connect an MCP client to run tasks that will emit a desktop notification with a sound.

Using Claude Desktop or Cursor, you configure the notifier as an MCP server so that the client can run it and send a notification when a task completes. In Claude Desktop, specify a server with the following runtime configuration, which runs the notifier via the UV runner.

In Cursor, point to the same notifier server configuration and add a prompt rule that ends with a task-related trigger, such as finally, send me a notification when task finished., so the AI will request a desktop alert at the end of a task.

How to install

git clone https://github.com/Cactusinhand/mcp_server_notify.git
cd mcp_server_notify

uv venv
source .venv/Scripts/activate

uv pip install mcp-server-notify
# or
pip install mcp-server-notify

After installing, verify the installation by running the notifier module directly.

python -m mcp_server_notify

Special requirements to enable desktop notifications depend on your OS. Install additional components for your platform.

# Windows
pip install pywin32

# macOS
brew install terminal-notifier

Additional sections

Configuration: You can run the notifier as a local MCP server using a simple stdio configuration. The notifier can be started via UV (a service manager) with the following runtime setup.

{
  "mcpServers": {
    "NotificationServer": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/your/mcp_server_notify project",
        "run",
        "mcp-server-notify",
      ]
    }
  }
}

If you install the notifier globally, you can start it with Python directly.

{
  "mcpServers": {
    "NotificationServer": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_notify",
      ]
    }
  }
}

Usage notes for integration with editors: VSCode users can install the UV service manager and add a server entry that runs the notifier, enabling Copilot to trigger notifications when you ask it to run a task. For example, set the server with command uvx and argument mcp-server-notify, then enable Copilot in agent mode and use a command like #send_notification to trigger the notification flow.

Docker running is not available for this notifier due to environment and host OS access limitations. Native notifications require host OS access that is not readily achievable inside containers.

Notes and tips

Tools and capabilities include sending desktop notifications, playing alert sounds, and integrating with the Apprise notification backend for cross-platform delivery. The server is built to be cross-platform and to work with standard MCP clients.

display_desktop_notification

Shows a desktop notification on the host system when a task completes.

play_alert_sound

Plays a sound file to accompany the notification to attract attention.

trigger_notification_on_task_completion

Integrates with MCP task flow to trigger the notification upon completion.

integrate_apprise_backend

Uses Apprise to deliver notifications to multiple desktop channels.