Integrations
Enables triggering macOS notifications, system sounds, and text-to-speech functionality, with support for customizable banner notifications, voice selection, and speech parameters.
🔔 macOS Notification MCP
A Model Context Protocol (MCP) server that enables AI assistants to trigger macOS notifications, sounds, and text-to-speech.
✨ Features
- 🔊 Sound Notifications: Play system sounds like Submarine, Ping, or Tink
- 💬 Banner Notifications: Display visual notifications with customizable title, message, and subtitle
- 🗣️ Speech Notifications: Convert text to speech with adjustable voice, rate, and volume
- 🎙️ Voice Management: List and select from available system voices
- 🧪 Testing Tools: Diagnostic utilities to verify all notification methods
🚀 Quick Start with uvx (Recommended)
The fastest way to use this tool is with uvx
, which runs packages without permanent installation:
⚙️ Configure Claude Desktop
Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json
):
Then restart Claude Desktop.
📦 Alternative Installation Methods
Standard installation:
Install from source:
🛠️ Available Notification Tools
🔊 Sound Notification
Available sounds: Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink
💬 Banner Notification
🗣️ Speech Notification
🎙️ Voice Management
🧪 Testing
🔒 Implementation Details
- ⏱️ Rate Limiting: Notifications are processed one at a time with a minimum interval of 0.5 seconds
- 🔄 Queuing: Multiple notification requests are handled sequentially
- 🪟 OS Integration: Uses native macOS commands (
afplay
,osascript
,say
) - 🔌 FastMCP: Built on the FastMCP framework for AI communication
⚠️ Troubleshooting
- 🔐 Permissions: Ensure notifications are allowed in System Settings → Notifications
- ⏳ Timing: Only one notification is processed at a time
- 🌐 Environment: If using the command directly (not uvx), you may need to use full paths
📄 License
MIT License
This server cannot be installed
macOS Notification MCP
Related MCP Servers
- AsecurityAlicenseAqualityA simple MCP server that can send notifications on mac devices.Last updated -598TypeScriptMIT License
- -securityAlicense-qualityThe MCP server that keeps you informed by sending the notification on phone using ntfy.shLast updated -186JavaScriptApache 2.0
- -securityFlicense-qualityAn 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.Last updated -1241TypeScript
- -security-license-qualityAn MCP server that displays desktop notifications on Windows 10 and macOS, compatible with VSCode Cline and supporting customizable notification parameters.Last updated -2PythonMIT License