MCP Notify Server is an MCP server that sends desktop notifications accompanied by audio alerts when AI agents complete tasks. Built on standard Model Context Protocol specifications, it interfaces between LLM environmentsāsuch as Claude Desktop, Cursor, and VS Code with GitHub Copilotāand the host operating system's native alert systems via the Apprise library. Developers and users running asynchronous or long-running AI tasks can use it to receive immediate feedback without constantly monitoring chat windows. The server supports cross-platform environments, functioning across Windows, macOS, and Linux systems. It includes bundled sound files that play automatically alongside visual desktop pop-ups whenever a notification tool call is invoked by the language model. By connecting automated code workflows, agent runs, and routine assistant interactions to desktop alerts, it ensures users are promptly informed as soon as background code generation, debugging, or complex research tasks conclude.
Category: Other & General Purpose
Tags: alerts, automation, desktop, notifications
pip install pywin32, or on macOS run brew install terminal-notifier. 2. Install mcp-server-notify using uv or pip: bash uv pip install mcp-server-notify 3. Configure your MCP client. For Claude Desktop or Cursor, add the following to claude_desktop_config.json or mcp.json: json { "mcpServers": { "NotificationServer": { "command": "python", "args": ["-m", "mcp_server_notify"] } } } 4. For VS Code with GitHub Copilot, register the server in settings.json using uvx: json "mcp": { "servers": { "notifier": { "command": "uvx", "args": ["mcp-server-notify"] } } } 5. Restart your client and prompt the AI to send a notification upon completing tasks.Part of MCP Servers
MCP Notify Server enables AI assistants to trigger native desktop notifications with sound effects. When an agent finishes a specified task, it calls the notification tool to alert the user across Windows, macOS, or Linux systems.
The server integrates with several MCP-compliant clients, including Claude Desktop, Cursor, and VS Code running GitHub Copilot in agent mode. Any standard client capable of running local MCP servers can utilize it.
Because notifications rely on the Apprise API, Windows environments require the pywin32 library, while macOS requires terminal-notifier installed via Homebrew. Linux environments use standard notification systems supported by Apprise.
Running the server inside Docker is currently not supported due to container isolation issues and difficulty accessing host operating system notification systems across different platforms.
Yes, MCP Notify Server is open source and licensed under the MIT License. Its source code and documentation are available on GitHub.