MCP Notify Server

What is MCP Notify Server?

A lightweight MCP server that plays macOS system notification sounds when Cursor or Windsurf completes code generation or requires user approval.

How to use MCP Notify Server?

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.

Key features of MCP Notify Server

• 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

Use cases of MCP Notify Server

• Stay informed when a long-running code generation finishes without checking the editor
• Get an audible prompt when the LLM requires your approval to run a tool
• Receive completion notifications while multitasking or working in another window

FAQ from MCP Notify Server

What are the system requirements?

macOS and Node.js 18 or later are required. The server currently supports macOS only.

How do I install MCP Notify Server?

Run npx -y @mkusaka/mcp-notify-server or install globally with npm install -g @mkusaka/mcp-notify-server.

How do I configure it in Cursor?

Add a notify entry under mcpServers in ~/.cursor/config.json using npx with the package name as the argument.

Does it work on Windows or Linux?

No, the server only supports macOS due to its reliance on macOS system notification sounds.

How reliable are the notifications?

Sound notifications depend on the LLM’s judgment, which may result in unexpected timing, occasional missed notifications, or variations in behavior.