█████╗ ██████╗ ██████╗ ██╗     ███████╗    ███╗   ██╗ ██████╗ ████████╗██╗
██╔══██╗██╔══██╗██╔══██╗██║     ██╔════╝    ████╗  ██║██╔═══██╗╚══██╔══╝██║
███████║██████╔╝██████╔╝██║     █████╗      ██╔██╗ ██║██║   ██║   ██║   ██║
██╔══██║██╔═══╝ ██╔═══╝ ██║     ██╔══╝      ██║╚██╗██║██║   ██║   ██║   ██║
██║  ██║██║     ██║     ███████╗███████╗    ██║ ╚████║╚██████╔╝   ██║   ██║
╚═╝  ╚═╝╚═╝     ╚═╝     ╚══════╝╚══════╝    ╚═╝  ╚═══╝ ╚═════╝    ╚═╝   ╚═╝
                                                                           
███████╗██╗ ██████╗ █████╗ ████████╗██╗ ██████╗ ███╗   ██╗                 
██╔════╝██║██╔════╝██╔══██╗╚══██╔══╝██║██╔═══██╗████╗  ██║                 
█████╗  ██║██║     ███████║   ██║   ██║██║   ██║██╔██╗ ██║                 
██╔══╝  ██║██║     ██╔══██║   ██║   ██║██║   ██║██║╚██╗██║                 
██║     ██║╚██████╗██║  ██║   ██║   ██║╚██████╔╝██║ ╚████║                 
╚═╝     ╚═╝ ╚═════╝╚═╝  ╚═╝   ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═══╝

@zyx1121/apple-notification-mcp

MCP server for Apple Notification — send notifications, alerts, and text-to-speech via Claude Code.

Install

claude mcp add apple-notification -- npx @zyx1121/apple-notification-mcp

Prerequisites

• macOS with Notification Center
• Node.js >= 18
• First run will prompt for Automation permission (System Settings > Privacy & Security > Automation)

Tools

| Tool | Description | |------|-------------| | notification_send | Send a macOS notification | | notification_say | Use macOS text-to-speech to speak text aloud | | notification_list_voices | List available macOS TTS voices | | notification_alert | Show a modal alert dialog and return which button was clicked | | notification_beep | Play the macOS system beep sound |

Available Sounds

default, Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

Examples

"Notify me when done"                    → notification_send { title: "Done", message: "Task completed" }
"Send a notification with Ping sound"    → notification_send { title: "Alert", message: "...", sound: "Ping" }
"Say hello"                              → notification_say { text: "Hello" }
"Read this in Victoria's voice"          → notification_say { text: "...", voice: "Victoria" }
"Ask me to confirm before continuing"    → notification_alert { title: "Confirm", message: "Continue?", buttons: ["OK", "Cancel"] }
"Beep three times"                       → notification_beep { times: 3 }
"List available voices"                  → notification_list_voices {}

Limitations

• macOS only (uses AppleScript and say command)

License

MIT — ding