notifications

This MCP server integrates with Claude Desktop to provide real-time completion feedback. When a long Claude task finishes, the server can trigger macOS native notifications and play configurable sounds to alert you without interfering with your current workflow. The project leverages FastMCP for model-context protocol integration and uses Python-based components to manage notifications and audio playback. Once running, Claude Desktop triggers the notifications automatically based on task completion, and you can customize the sound behavior and notification settings via the provided configuration.

You can customize the server via the standard MCP configuration and, if desired, modify the local configuration to control whether sounds are played, which sound file to use, and the audio volume. The example configuration ships with sensible defaults and can be extended to add new platforms in the future (e.g., Linux notify-send or Windows Toast).

Prerequisites:

• Python 3.8+
• pip
• Claude Desktop installed and configured to point to this MCP server

Step-by-step installation:

1. Install the package from PyPI (or from source if preferred):

pip install notifications-mcp-server

2. Verify installation by listing the installed package (optional):

pip show notifications-mcp-server

3. Configure Claude Desktop to use the MCP server (see configuration example below).

4. Start the server if running in a non-standard environment (optional since Claude Desktop will invoke it via MCP):

python -m notifications_mcp_server

5. Restart Claude Desktop to ensure the MCP server is discovered and initialized.

Notes and tips:

• Default configuration enables notifications with sound. You can customize with the following in your Claude Desktop config: { "mcpServers": { "notifications": { "command": "python", "args": ["-m", "notifications_mcp_server"] } } }
• Sounds can be changed by placing custom sound files in the standard directory (e.g., ~/.config/notifications-mcp/sounds/) and updating the config accordingly.
• If you encounter issues with macOS notifications, ensure the app has permission in System Preferences > Notifications and that Claude Desktop is allowed to display notifications.
• Logs are typically found under ~/.config/notifications-mcp/logs/server.log; check there for troubleshooting information.
• This server is designed to be non-blocking and should not impact Claude task execution timing.