Apple Notifier MCP Server

View original on GitHub

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)

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

Install the package globally:


npm install -g apple-notifier-mcp

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
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
type (required): ‘fullscreen’ | ‘window’ | ‘selection’ - Type of screenshot
format (optional): ‘png’ | ‘jpg’ | ‘pdf’ | ‘tiff’ - Image format
hideCursor (optional): boolean - Whether to hide the cursor
shadow (optional): boolean - Whether to include window shadow (only for window type)
timestamp (optional): boolean - Add timestamp to filename

File Selection

Open native macOS file picker dialog.

Parameters:

prompt (optional): string - Prompt message
defaultLocation (optional): string - Default directory path
fileTypes (optional): object - File type filter (e.g., {“public.image”: [“png”, “jpg”]})
multiple (optional): boolean - Allow multiple file selection

Example Usage


// Send a notification
await client.use_mcp_tool("apple-notifier", "send_notification", {
  title: "Hello",
  message: "World",
  sound: true
});
 
// Show a prompt
const result = await client.use_mcp_tool("apple-notifier", "prompt_user", {
  message: "What's your name?",
  defaultAnswer: "John Doe",
  buttons: ["OK", "Cancel"]
});
 
// Speak text
await client.use_mcp_tool("apple-notifier", "speak", {
  text: "Hello, world!",
  voice: "Samantha",
  rate: -20
});
 
// Take a screenshot
await client.use_mcp_tool("apple-notifier", "take_screenshot", {
  path: "screenshot.png",
  type: "window",
  format: "png"
});
 
// Select files
const files = await client.use_mcp_tool("apple-notifier", "select_file", {
  prompt: "Select images",
  fileTypes: {
    "public.image": ["png", "jpg", "jpeg"]
  },
  multiple: true
});

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT License - see the LICENSE file for details.