MCP Notify Server

You have an MCP server that plays macOS system notification sounds when Cursor/Windsurf finishes code generation or needs your approval. It’s lightweight, easy to wire into your workflow, and helps you stay on top of long-running tasks without watching the screen.

How to use

Set up the MCP server in your client so you receive audible cues at key moments. You can configure it to notify when code generation finishes and when you must approve running a tool. Use the dedicated notify MCP server name you configured in your client, and keep the rule flow simple: one sound notification per event to avoid overload.

How to install

Prerequisites: macOS and Node.js 18 or later.

npx -y @mkusaka/mcp-notify-server

Or install the MCP server globally so you can run it from anywhere.

npm install -g @mkusaka/mcp-notify-server

Configure the MCP server in your Cursor client by adding the following to your Cursor configuration file.

{
  "mcpServers": {
    "notify": {
      "command": "npx",
      "args": ["-y", "@mkusaka/mcp-notify-server"]
    }
  }
}

Configuration

Assign the notify MCP server in your client so it can run locally and emit sounds as needed.

{
  "mcpServers": {
    "notify": {
      "command": "npx",
      "args": ["-y", "@mkusaka/mcp-notify-server"]
    }
  }
}

Rule Configuration

Set your Cursor rules to Always Notify by sound using the notify server. Use it for moments when you need the user’s attention, such as requesting approval or when a task finishes. Ensure you do not trigger more than one sound notification for the same event.

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

If you want to work with the MCP server sources locally, follow these steps to set up, build, and run the server.

git clone https://github.com/mkusaka/mcp-notify-server.git
cd mcp-notify-server
npm install
npm run build

Inspection

Test the MCP server interactively with the inspector tool to verify tools and behavior.

npm run inspect

Caveats

This server is designed for macOS and relies on the system notification sounds. Timing and behavior may vary based on context and the underlying LLM decisions.

Notes

If you plan to customize further, you can extend the rule set or add more events to notify. Keep the notifications concise to avoid fatigue.

Available tools

inspect

Starts interactive inspection mode to test the MCP server's tools and functionality in an interactive environment.