Skip to main content
Glama

Sound Notification MCP

by ks0318-p

Sound Notification MCP (JPN followed By ENG)

This project is an MCP server that lets AI coding assistants like Windsurf and Cursor play notification sounds when they need user attention. It can play notification sounds when coding is finished or when user approval is needed.

Notes & Disclaimer

  • *When adding settings, be sure to add the setting to the rules (memory for Windsurf) as a set.
  • Currently it only supports MacOS.
  • Since the MCP CALL is left to the discretion of the LLM, there is a possibility that sounds may be heard at unexpected times or that the device may not function as expected.
  • In both Cursor and Windsurf, there is often no confirmation prompt before executing a command.
  • Windsurf may ring the notification sound multiple times when you exit the app. (Please note that this will consume credits.)

set up

Prerequisites

  • Node.js (v18 or higher)
  • Yarn

install

# リポジトリをクローン git clone <repository-url> cd sound-notification-mcp # 依存関係のインストール yarn install # ビルド yarn build

Now you're ready to go.

Settings for Windsurf and Cursor

Cursor

A sample is listed in /.cursor/mcp.json. (If you write it in /.cursor/mcp.json, you will need to write it for each project. If you want to enable it globally, please set it from the settings icon.)

Windsurf

Write the settings in mcp_config.json . It is fine to use the same contents as /.cursor/mcp.json.

Customization

Change notification sound

Change the following in src/index.ts file:

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOSのデフォルトサウンド

The system sounds available on macOS are located in /System/Library/Sounds/ directory:

  • Bottle.aiff
  • Frog.aiff
  • Funk.aiff
  • Glass.aiff
  • Hero.aiff
  • Morse.aiff
  • Ping.aiff
  • Pop.aiff
  • Purr.aiff
  • Sosumi.aiff
  • Submarine.aiff
  • Tink.aiff

troubleshooting

If there is no sound

  1. Make sure your system volume is set properly.
  2. Please check that the specified audio file exists.
  3. Check the terminal output for error messages.

If the MCP server does not start

  1. Make sure you have Node.js and Yarn installed correctly.
  2. Make sure the dependencies are installed correctly:
    yarn install
  3. Check for build errors:
    yarn build

license

MIT


English Version

This project is an MCP server that plays notification sounds when AI coding assistants like Windsurf or Cursor require user attention. It can play notification sounds when coding is complete or when user approval is needed.

Notes & Disclaimer

  • * When adding settings, please always add corresponding entries to the rules.
  • Currently only supports MAC as the creator uses a Mac and cannot verify on Windows.
  • Since MCP CALLS depend on LLM judgment, sounds may play at unexpected times or not work as expected.
  • For Cursor, sounds may sometimes not play before command execution approval.
  • With Windsurf, there is a phenomenon where notification sounds may play multiple times.

Setup

Prerequisites

  • Node.js (v18 or higher)
  • Yarn

Installation

# Clone the repository git clone <repository-url> cd sound-notification-mcp # Install dependencies yarn install # Build yarn build

Now you're ready to go.

Configuration for Windsurf and Cursor

Cursor

A sample configuration is provided in /.cursor/mcp.json (Writing to /.cursor/mcp.json requires configuration for each project. If you want to enable it globally, please configure it from the settings icon.)

Windsurf

Add configuration to mcp_config.json . The content can be exactly the same as /.cursor/mcp.json .

For Windsurf, it is also strongly recommended to:

  1. Add the notification instructions to your global_rules.md file
  2. Add the notification settings to your memories

This ensures that the AI assistant consistently uses sound notifications when needed.

Customization

Changing the Notification Sound

Modify the following section in the src/index.ts file:

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOS default sound

System sounds available on macOS can be found in the /System/Library/Sounds/ directory:

  • Bottle.aiff
  • Frog.aiff
  • Funk.aiff
  • Glass.aiff
  • Hero.aiff
  • Morse.aiff
  • Ping.aiff
  • Pop.aiff
  • Purr.aiff
  • Sosumi.aiff
  • Submarine.aiff
  • Tink.aiff

Troubleshooting

If No Sound Plays

  1. Check that the system volume is properly set.
  2. Verify that the specified sound file exists.
  3. Check the terminal output for error messages.

If the MCP Server Fails to Start

  1. Verify that Node.js and Yarn are correctly installed.
  2. Check that dependencies are properly installed:
    yarn install
  3. Check for build errors:
    yarn build

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that plays notification sounds when AI coding assistants like Windsurf or Cursor require user attention, such as when coding is complete or when user approval is needed.

  1. Notes & Disclaimer
    1. set up
      1. Prerequisites
      2. install
      3. Settings for Windsurf and Cursor
    2. Customization
      1. Change notification sound
    3. troubleshooting
      1. If there is no sound
      2. If the MCP server does not start
    4. license
      1. English Version
        1. Notes & Disclaimer
        2. Setup
        3. Customization
        4. Troubleshooting
        5. License

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol implementation that plays sound effects (completion, error, notification) for Cursor AI and other MCP-compatible environments, providing audio feedback for a more interactive coding experience.
        Last updated -
        1
        Python
        MIT License
        • Apple
        • Linux
      • A
        security
        F
        license
        A
        quality
        An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
        Last updated -
        11
        61
        TypeScript
        • Linux
        • Apple
      • -
        security
        F
        license
        -
        quality
        An MCP server that gives AI assistants like Cursor, Claude and Windsurf the ability to remember user information across conversations using vector search technology.
        Last updated -
      • A
        security
        A
        license
        A
        quality
        An advanced MCP server that provides interactive feedback mechanisms with support for various feedback types, multi-language capabilities, and team collaboration features for AI tools like Cursor, Cline, and Windsurf.
        Last updated -
        4
        1
        Python
        MIT License
        • Apple
        • Linux

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/ks0318-p/sound-notification-mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server