MCP Notify Server

1<a href="https://glama.ai/mcp/servers/@Cactusinhand/mcp_server_notify"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@Cactusinhand/mcp_server_notify/badge" alt="Glama badge for Notify MCP server" /> </a> [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cactusinhand-mcp-server-notify-badge.png)](https://mseep.ai/app/cactusinhand-mcp-server-notify) 
2 
3[![PyPI version](https://badge.fury.io/py/mcp-server-notify.svg)](https://badge.fury.io/py/mcp-server-notify)
4 
5[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/Cactusinhand/mcp_server_notify)](https://archestra.ai/mcp-catalog/Cactusinhand__mcp_server_notify)
6 
7 
8# 📢 MCP Notify Server
9 
10 
11 
12[English](README.md) | [中文](README.zh.md)
13 
14A MCP server that send desktop notifications with sound effect when agent tasks are completed.
15 
16## 🥩 Features
17 
18- Send system desktop notifications after agent tasks completion
19- Play alert sounds to grab user attention, with sound file inside.
20- Cross-platform support (Windows, macOS, Linux)
21- Based on standard MCP protocol, integrates with various LLM clients
22 
23## ⏬ Installation
24 
25### Install using [uv](https://docs.astral.sh/uv/) package manager
26 
27```bash
28git clone https://github.com/Cactusinhand/mcp_server_notify.git
29cd mcp_server_notify
30 
31uv venv
32source .venv/Scripts/activate
33 
34uv pip install mcp-server-notify
35# or
36pip install mcp-server-notify
37```
38 
39After installation, call the module directly to check if installation was successful:
40```bash
41python -m mcp_server_notify
42```
43This module accepts ` --debug ` or `--file ` option, we can use it like:
44```shell
45python -m mcp_server_notify --debug
46python -m mcp_server_notify --debug --log-file=path/to/logfile.log
47```
48 
49## ⚠️❕ Special requirements
50 
51** We use [Apprise](https://github.com/caronc/apprise) API for our Desktop notification deliver，so we need to install some special requirements in our Desktop **
52 
53**Windows**
54```shell
55# windows:// minimum requirements
56pip install pywin32
57```
58 
59**macOS**
60```shell
61# Make sure terminal-notifier is installed into your system
62brew install terminal-notifier
63```
64 
65## 📚 Usage
66 
67### Using with Claude Desktop:
68 
69Find the configuration file `claude_desktop_config.json`
70```json
71{
72    "mcpServers": {
73        "NotificationServer": {
74            "command": "uv",
75            "args": [
76              "--directory",
77              "path/to/your/mcp_server_notify project",
78              "run",
79              "mcp-server-notify",
80            ]
81        }
82    }
83}
84```
85 
86If installed globally, you can also use the python command:
87```json
88{
89    "mcpServers": {
90        "NotificationServer": {
91            "command": "python",
92            "args": [
93              "-m",
94              "mcp_server_notify",
95            ]
96        }
97    }
98}
99```
100 
101### ⚡️ Using with Cursor:
102Find the configuration file `~/.cursor/mcp.json` or `your_project/.cursor/mcp.json`
103```json
104{
105    "mcpServers": {
106        "NotificationServer": {
107            "command": "uv",
108            "args": [
109              "--directory",
110              "path/to/your/mcp_server_notify project",
111              "run",
112              "mcp-server-notify",
113            ]
114        }
115    }
116}
117```
118 
119After 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.
120 
121In Cursor, you can add this prompt as a rule in `Cursor Settings` -> `Rules` so you don't have to type it manually each time.
122 
123### ⚡️ Using with VSCode + Copilot:
1241.	Install the service manager [uv/uvx](https://docs.astral.sh/uv/):
125`pip install uv`
1262.	 Add the service to VSCode settings:
127 
128     Windows `%APPDATA%\Code\User\settings.json`  
129macOS `$HOME/Library/Application\ Support/Code/User/settings.json`  
130Linux `$HOME/.config/Code/User/settings.json`  
131 
132	 ```json
133	 "mcp": {
134         "servers": {
135             "notifier": {
136                 "command": "uvx",
137                 "args": [
138                     "mcp-server-notify"
139                 ],
140                 "env": {}
141             }
142         }
143	 }
144	 ```
1453.	Make sure you are using the latest VSCode version — it automatically runs MCP services
1464.	Open VSCode → enable Copilot → switch to agent mode.
1475.	Type # → you will see the #send_notification option.
1486.	Ask the agent: run #send_notification (it will handle the notification automatically).
1497.	Now the Copilot in agent mode can send desktop notifications.
150 
151 
152 
153### 🐳 Running with Docker
154 
155Currently not available due to environment compatibility issues.
156If 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.
157 
158Main issues:
1591. OS-specific notification systems
160Each operating system (Windows, macOS, Linux) has its unique notification mechanism.
161 
1622. Docker isolation
163The isolation of Docker containers limits their ability to access host operating system resources directly.
164 
1653. Dependency management
166Need to handle different notification libraries and dependencies for each operating system.
167 
168## 🧾 License
169 
170MIT
171 
172## 💻 Contributions
173 
174Issues and pull requests are welcome!
175