Macos Notification Mcp

Trigger macOS notifications, sounds, and text-to-speech from an AI assistant.

A Model Context Protocol (MCP) server that enables AI assistants to trigger macOS notifications, sounds, and text-to-speech.

- 🔊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

The fastest way to use this tool is withuvx, 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"] } } }

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

- ⏱️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

- 🔐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

Provides macOS utility tools for AI assistants, including sending native notifications with project context.

Reads text aloud locally on Windows, macOS, and Linux using the operating system's built-in speech engine. No API key, no account, no special hardware required, and no cloud service — text never leaves the machine.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

On-device tools to detect AI-generated text and images, score readability, and strip AI artifacts, running locally on Apple silicon.

Interact with Apple Notes using natural language on macOS.

Free local MCP server for Apple Mail, Calendar, and Reminders on macOS.

A server for native integration with Apple Reminders on macOS.

Execute AppleScript to gain full control of your Mac.

Native macOS Calendar & Reminders MCP server with 24 tools using Swift EventKit - supports recurring events, location triggers, search, batch operations