通过任何兼容MCP的客户端（如Claude Desktop或Cline）发送原生macOS通知并与系统对话框交互。

先修条件

• macOS
• Node.js >= 18
• 一个兼容MCP的客户端（Claude Desktop，Cline）

故障排查：通知未出现

为了显示通知，运行 MCP 服务器的终端或应用程序需要在 macOS 中获得通知权限。

授予通知权限

1. 针对Claude桌面用户：

• 打开系统偏好设置（或macOS Ventura+中的系统设置）
• 前往通知
• 查找Node或终端通知器（以出现者为准）
• 启用允许通知
• 将警报样式设置为横幅或警报

2. 针对Claude代码/终端用户：

• 打开 系统偏好设置 > 通知
• 查找Terminal（或使用iTerm2则称为iTerm）
• 启用允许通知

3. 如果应用没有出现在通知设置中：

• 在终端中手动运行测试通知：

• 这应触发macOS提示或注册通知权限

• 然后再次检查系统偏好设置

4. 检查对焦模式/请勿打扰：

Apple Notifier MCP Server

Send native macOS notifications and interact with system dialogs through any MCP-compatible client like Claude Desktop or Cline.

Prerequisites

• macOS
• Node.js >= 18
• An MCP-compatible client (Claude Desktop, Cline)

Troubleshooting: Notifications Not Appearing

For notifications to display, the terminal or application running the MCP server needs notification permissions in macOS.

Grant Notification Permissions

1. For Claude Desktop users:

   • Open System Preferences (or System Settings on macOS Ventura+)
   • Go to Notifications
   • Find Node or terminal-notifier (whichever appears)
   • Enable Allow Notifications
   • Set alert style to Banners or Alerts

2. For Claude Code / Terminal users:

   • Open System Preferences > Notifications
   • Find Terminal (or iTerm if using iTerm2)
   • Enable Allow Notifications

3. If the app doesn’t appear in Notifications settings:

   • Run a test notification manually in Terminal:

     osascript -e 'display notification "Test" with title "Hello"'
     

   • This should trigger macOS to prompt for or register notification permissions
   • Then check System Preferences again

4. Check Focus Mode / Do Not Disturb:

   • Ensure Focus Mode or Do Not Disturb is not enabled
   • Check the Control Center in the menu bar

Verify Notifications Work

Test from terminal before using via MCP:

osascript -e 'display notification "Test message" with title "Test title"'

If this shows a notification, the MCP server should work correctly.

Installation

Installing via Smithery

To install Apple Notifier for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install apple-notifier-mcp --client claude

Manual Installation

1. Install the package globally:

npm install -g apple-notifier-mcp

2. Add to your MCP configuration file:

For Cline (cline_mcp_settings.json):

{
  "mcpServers": {
    "apple-notifier": {
      "command": "apple-notifier-mcp"
    }
  }
}

For Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "apple-notifier": {
      "command": "apple-notifier-mcp"
    }
  }
}

Features

Send Notifications

Display native macOS notifications with customizable content.

Parameters:

• title (required): string - The title of the notification