Enables AI assistants to trigger macOS notifications, sounds, and customizable text-to-speech using the Model Context Protocol with features like voice management, sound alerts, banner notifications, and sequential processing for seamless OS integration.
Unlock the full potential of macOS Notification MCP through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.
Free tier available โข No credit card required
A Model Context Protocol (MCP) server that enables AI assistants to trigger macOS notifications, sounds, and text-to-speech.
The fastest way to use this tool is with uvx
, which runs packages without permanent installation:
# Install uv if you don't have it curl -LsSf https://astral.sh/uv/install.sh | sh # Run the MCP server directly (no installation needed) uvx macos-notification-mcp
Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json
):
{ "mcpServers": { "macos-notification-mcp": { "command": "uvx", "args": ["macos-notification-mcp"] } } }
Then restart Claude Desktop.
Standard installation:
pip install macos-notification-mcp
Install from source:
git clone https://github.com/devizor/macos-notification-mcp cd macos-notification-mcp pip install .
sound_notification(sound_name="Submarine")
Available sounds: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink
banner_notification( title="Task Complete", message="Your analysis is ready", subtitle=None, # Optional sound=False, # Optional: Play sound with notification sound_name=None # Optional: Specify system sound )
speak_notification( text="The process has completed", voice=None, # Optional: System voice to use rate=150, # Optional: Words per minute (default: 150) volume=1.0 # Optional: Volume level 0.0-1.0 )
list_available_voices() # Lists all available text-to-speech voices
test_notification_system() # Tests all notification methods
afplay
, osascript
, say
)MIT License
Discover shared experiences
Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!