Claude Notification Server
by charles-adedotun
A lightweight MCP server that provides auditory and visual notifications for Claude Desktop on macOS. It informs you when Claude starts processing a request and when it completes a task.
Last updated: N/A
What is Claude Notification Server?
The Claude Notification Server is a lightweight MCP server designed to provide auditory and visual notifications for the Claude Desktop application on macOS. It enhances the user experience by signaling the start and end of Claude's processing tasks.
How to use Claude Notification Server?
To use the server, clone the repository, install the necessary dependencies (including uv and optionally pyobjc-core and pyobjc-framework-Cocoa), and configure Claude Desktop to use the server by adding the provided JSON configuration to Claude's settings. Ensure the path to server.py is correct. Restart Claude Desktop to activate the notifications.
Key features of Claude Notification Server
Sound notifications at the beginning and end of Claude responses
Compatible with macOS native system sounds (.aiff files)
Customizable notification sounds via environment variables
Visual desktop notifications through macOS Notification Center
Custom icons for visual notifications
Simple setup with minimal dependencies
Multiple notification methods with fallbacks (PyObjC, pync, AppleScript, terminal-notifier)
Use cases of Claude Notification Server
Enhance user awareness of Claude's processing status
Provide auditory cues for task start and completion
Offer visual notifications for users who prefer or require them
Customize notification sounds and icons to personal preferences
FAQ from Claude Notification Server
Visual Notifications Not Working?
Visual Notifications Not Working?
Run the test script (python3 test_notification.py), check notification permissions in System Preferences, try installing terminal-notifier (brew install terminal-notifier), and check the server logs.
Sound Notifications Not Working?
Sound Notifications Not Working?
Verify your macOS sound settings, check custom sound paths, and ensure you're using .aiff files.
Server Not Connecting?
Server Not Connecting?
Verify Claude Desktop configuration, restart everything, check dependencies, and check the server logs.
How do I customize the notification sounds?
How do I customize the notification sounds?
Set the CLAUDE_START_SOUND and CLAUDE_COMPLETE_SOUND environment variables to the paths of your desired .aiff files.
How do I disable visual notifications?
How do I disable visual notifications?
Set the CLAUDE_VISUAL_NOTIFICATIONS environment variable to "false".