MCP Notify Server

Integrations

  • Enables system desktop notifications on Linux platforms when AI tasks are completed

  • Provides native desktop notification support for macOS systems when AI task completion occurs

📢 MCP Notify Server

English | 中文

A MCP server that send desktop notifications with sound effect when agent tasks are completed.

🥩 Features

  • Send system desktop notifications after agent tasks completion
  • Play alert sounds to grab user attention, with sound file inside.
  • Cross-platform support (Windows, macOS, Linux)
  • Based on standard MCP protocol, integrates with various LLM clients

⏬ Installation

Install using uv package manager

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 installation, call the module directly to check if installation was successful:

python -m mcp_server_notify

This module accepts --debug or --file option, we can use it like:

python -m mcp_server_notify --debug python -m mcp_server_notify --debug --log-file=path/to/logfile.log

⚠️❕ Special requirements

** We use Apprise API for our Desktop notification deliver,so we need to install some special requirements in our Desktop **

Windows

# windows:// minimum requirements pip install pywin32

macOS

# Make sure terminal-notifier is installed into your system brew install terminal-notifier

📚 Usage

Using with Claude Desktop:

Find the configuration file claude_desktop_config.json

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

If installed globally, you can also use the python command:

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

⚡️ Using with Cursor:

Find the configuration file ~/.cursor/mcp.json or your_project/.cursor/mcp.json

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

After configuration, simply add a prompt like finally, send me a notification when task finished. at the end of your task input to the AI to trigger notifications.

In Cursor, you can add this prompt as a rule in Cursor Settings -> Rules so you don't have to type it manually each time.

🐳 Running with Docker

Currently not available due to environment compatibility issues. If Docker containers need to trigger host notifications regardless of whether the host OS is Windows, macOS, or Linux, the solution becomes much more complex, and direct use of native notifications is usually not feasible.

Main issues:

  1. OS-specific notification systems Each operating system (Windows, macOS, Linux) has its unique notification mechanism.
  2. Docker isolation The isolation of Docker containers limits their ability to access host operating system resources directly.
  3. Dependency management Need to handle different notification libraries and dependencies for each operating system.

🧾 License

MIT

💻 Contributions

Issues and pull requests are welcome!

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

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

A Model Context Protocol service that sends desktop notifications and alert sounds when AI agent tasks are completed, integrating with various LLM clients like Claude Desktop and Cursor.

  1. 🥩 Features
    1. ⏬ Installation
      1. Install using uv package manager
    2. ⚠️❕ Special requirements
      1. 📚 Usage
        1. Using with Claude Desktop:
        2. ⚡️ Using with Cursor:
        3. 🐳 Running with Docker
      2. 🧾 License
        1. 💻 Contributions

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol implementation that enables AI agents to send notifications through Pushover.net, supporting message customization with various parameters like priority, sound, and URL.
            Last updated -
            31
            7
            TypeScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants like Claude to interact with Zulip workspaces, supporting capabilities such as posting messages, listing channels, sending direct messages, and accessing conversation history.
            Last updated -
            JavaScript
            Apache 2.0
          • -
            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 -
            18
            7
            TypeScript
            Apache 2.0
            • Apple
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that bridges AI assistants like Claude with Wordware's specialized agent capabilities, allowing dynamic loading and access to any Wordware flow through a standardized interface.
            Last updated -
            Python

          View all related MCP servers

          ID: uawcbevk3j