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).

沟通协作分类下的更多 MCP 服务器

MCP Communicator (Telegram)

qpd-v

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.