MCP Notify Server
Description
# MCP Notify Server A MCP server that plays notification sounds when Cursor/Windsurf completes code generation or requires user approval. ## Features - Uses macOS system notification sounds - Notifies when code generation is complete - Notifies when user approval is needed -…
About
# MCP Notify Server A MCP server that plays notification sounds when Cursor/Windsurf completes code generation or requires user approval. ## Features - Uses macOS system notification sounds - Notifies when code generation is complete - Notifies when user approval is needed - Simple and lightweight ## Requirements -…
Details
- Author
- mkusaka
- Downloads
- 299
- Categories
- Other
Jump to
- Uses macOS system notification sounds
- Notifies when code generation is complete
- Notifies when user approval is needed
- Simple and lightweight setup
- Configurable via Cursor rule file
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Notify ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npx -y @mkusaka/mcp-notify-server or npm install -g @mkusaka/mcp-notify-server. Then add the server to your Cursor configuration file and create a rule instructing the LLM to use the "notify" tool whenever user attention is needed.
notify
Play a notification sound
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp notify server": {
"mcp-notify-server": {
"command": "npx",
"args": [
"-y",
"@mkusaka/mcp-notify-server"
]
}
}
}
}McpServers
{
"mcp-notify-server": {
"command": "npx",
"args": [
"-y",
"@mkusaka/mcp-notify-server"
]
}
}MCP Notify Server
A MCP server that plays notification sounds when Cursor/Windsurf completes code generation or requires user approval.
Features
- Uses macOS system notification sounds
- Notifies when code generation is complete
- Notifies when user approval is needed
- Simple and lightweight
Requirements
- macOS
- Node.js 18 or later
Installation
npx -y @mkusaka/mcp-notify-server
Or install globally:
npm install -g @mkusaka/mcp-notify-server
Configuration
Add the following to your Cursor configuration file (~/.cursor/config.json):
{
"mcpServers": {
"notify": {
"command": "npx",
"args": ["-y", "@mkusaka/mcp-notify-server"]
}
}
}
Rule Configuration
Add the following to your Cursor rules file:
Always Notify by sound using "notify" every time you need user attention
- when you need user's approval for running the tool
- when you finish the task
- DO NOT MAKE MORE THAN ONE SOUND NOTIFICATION.
Development
Setup
git clone https://github.com/mkusaka/mcp-notify-server.git
cd mcp-notify-server
npm install
npm run build
Inspection
You can test the MCP server interactively using mcp-inspector:
npm run inspect
This allows you to test the server's tools and functionality in an interactive environment.
Available Scripts
- npm run build - Build the project
- npm run start - Start the server
- npm run dev - Start the development mode with watch
- npm run inspect - Start the interactive inspection mode
Caveats
- Currently supports macOS only
- Sound notifications depend on LLM's judgment, which may result in:
- Unexpected timing of notifications
- Occasional missed notifications
- Potential variations in behavior
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
ISC
Author
@mkusaka
References
@ks0318-p's article about sound notification MCP
MCP Server Best Practices
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
