turlockmike/apple-notifier-mcp

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:
bash
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:
bash
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:
bash
npx -y @smithery/cli install apple-notifier-mcp --client claude
### Manual Installation
1. Install the package globally:
bash
npm install -g apple-notifier-mcp
2. Add to your MCP configuration file:
For Cline (cline_mcp_settings.json):
json
"mcpServers": {
"apple-notifier": {
"command": "apple-notifier-mcp"
For Claude Desktop (claude_desktop_config.json):
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
message (required): string - The main message content
subtitle (optional): string - A subtitle to display
sound (optional): boolean - Whether to play the default notification sound (default: true)
### Display Prompts
Show interactive dialog prompts to get user input.
Parameters:
message (required): string - Text to display in the prompt dialog
defaultAnswer (optional): string - Default text to pre-fill
buttons (optional): string[] - Custom button labels (max 3)
icon (optional): 'note' | 'stop' | 'caution' - Icon to display
### Text-to-Speech
Use macOS text-to-speech capabilities.
Parameters:
text (required): string - Text to speak
voice (optional): string - Voice to use (defaults to system voice)
rate (optional): number - Speech rate (-50 to 50, defaults to 0)
### Take Screenshots
Capture screenshots using macOS screencapture.
Parameters:
path (required): string - Path where to save the screenshot