macOS Notification

macOS Notification MCP enables AI assistants to trigger native macOS sounds, visual notifications, and text-to-speech. Built for Claude and other AI models using the Model Context Protocol.

python

34

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "devizor-macos-notification-mcp": {
      "command": "uvx",
      "args": [
        "macos-notification-mcp"
      ]
    }
  }
}

You can run a macOS Notification MCP server to trigger system notifications, play sounds, and perform text-to-speech from AI assistants. It lets you alert users with banners, audible cues, or spoken messages, and it includes tools to manage voices and test functionality.

How to use

You interact with the macOS Notification MCP server from an MCP client. Use it to display banner notifications with customizable titles and messages, play built-in system sounds, and convert text to speech. You can list available system voices and choose a voice for speech output. Start by running the server through a local MCP client, then send requests to trigger the different notification methods.

How to install

Prerequisites you need before installing: Python (recommended) and a working internet connection. You may also use the uvx workflow for a rapid, no-install start.

# Install uv with a quick script (if you want to run without permanent installation)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Start the MCP server directly using uvx (no installation needed)
uvx macos-notification-mcp

Claude Desktop configuration (example)

Configure Claude Desktop to load the MCP server by adding an entry that points to the uvx runtime and the macos-notification-mcp target.

{
  "mcpServers": {
    "macos-notification-mcp": {
      "command": "uvx",
      "args": ["macos-notification-mcp"]
    }
  }
}

Available tools

sound_notification

Play a system sound from a provided list (e.g., Submarine, Ping, Tink) to accompany notifications.

banner_notification

Display a banner notification with a title, message, and optional subtitle, and optionally play a sound.

speak_notification

Convert text to speech with configurable voice, rate, and volume.

list_available_voices

Query and list all text-to-speech voices available on the system.

test_notification_system

Run a diagnostic test to verify all notification methods (sound, banner, and speech) are functioning.