Skip to main content
Glama

macOS Notification MCP

by devizor

🔔 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

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

⚙️ Configure Claude Desktop

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.

📦 Alternative Installation Methods

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 .

🛠️ Available Notification Tools

🔊 Sound Notification

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 )

🗣️ Speech Notification

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 )

🎙️ Voice Management

list_available_voices() # Lists all available text-to-speech voices

🧪 Testing

test_notification_system() # Tests all notification methods

🔒 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

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

macOS Notification MCP

  1. ✨ Features
    1. 🚀 Quick Start with uvx (Recommended)
      1. ⚙️ Configure Claude Desktop
        1. 📦 Alternative Installation Methods
          1. 🛠️ Available Notification Tools
            1. 🔊 Sound Notification
            2. 💬 Banner Notification
            3. 🗣️ Speech Notification
            4. 🎙️ Voice Management
            5. 🧪 Testing
          2. 🔒 Implementation Details
            1. ⚠️ Troubleshooting
              1. 📄 License

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  A simple MCP server that can send notifications on mac devices.
                  Last updated -
                  5
                  9
                  8
                  TypeScript
                  MIT License
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  The MCP server that keeps you informed by sending the notification on phone using ntfy.sh
                  Last updated -
                  18
                  6
                  JavaScript
                  Apache 2.0
                  • Linux
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  An 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 -
                  124
                  1
                  TypeScript
                  • Apple
                • -
                  security
                  -
                  license
                  -
                  quality
                  An MCP server that displays desktop notifications on Windows 10 and macOS, compatible with VSCode Cline and supporting customizable notification parameters.
                  Last updated -
                  2
                  Python
                  MIT License

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/devizor/macOS-Notification-MCP'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server