Macos Notification Mcp

Name: Macos Notification Mcp
Author: devizor

@devizor

Macos Notification Mcp について

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.

#mcp #macos #text-to-speech #notification

基本情報

カテゴリ

コミュニケーション

トランスポート

stdio

公開者

devizor

投稿者

Phatchara Maichandi

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Macos Notification Mcp?

Macos Notification Mcp is a Model Context Protocol (MCP) server that enables AI assistants to trigger macOS notifications, sounds, and text‑to‑speech. It integrates with native macOS commands and is built on the FastMCP framework.

How to use Macos Notification Mcp?

Install and run via uvx macos-notification-mcp (recommended) or pip install macos-notification-mcp. Configure it as an MCP server in Claude Desktop by adding the command to claude_desktop_config.json. Once running, the AI assistant can call tools such as sound_notification, banner_notification, speak_notification, list_available_voices, and test_notification_system.

Key features of Macos Notification Mcp

Sound notifications using system sounds (e.g., Submarine, Ping, Tink)
Banner notifications with customizable title, message, and subtitle
Text‑to‑speech with adjustable voice, rate, and volume
Voice management: list and select available system voices
Diagnostic testing tool to verify all notification methods
Rate‑limited queuing (0.5‑second minimum interval between notifications)

Use cases of Macos Notification Mcp

Alert when a long‑running task completes
Read aloud a status update using text‑to‑speech
Play a system sound to signal an error or milestone
Test notification capabilities during development
Provide non‑blocking feedback from an AI assistant

FAQ from Macos Notification Mcp

Do I need any special permissions?

Yes. Ensure notifications are allowed in System Settings → Notifications for the app or script that triggers them.

What are the runtime requirements?

The server runs only on macOS because it relies on native commands (afplay, osascript, say). Python 3.7+ is required if installed via pip.

How are multiple notifications handled?

Notifications are processed one at a time with a minimum 0.5‑second interval. Additional requests are queued and handled sequentially.

Which transport and authentication does the server use?

The server uses the standard MCP transport (stdio) over the FastMCP framework. No authentication is built‑in; the server is intended for local use.

Can I customize the speech voice and speed?

Yes. The speak_notification tool accepts optional parameters for voice (a system voice name), rate (words per minute, default 150), and volume (0.0 to 1.0).