What can you do with this server?

The Apple Notifier MCP Server enables interaction with macOS system features through MCP-compatible clients: * **Send Notifications**: Display native macOS notifications with customizable title, message, subtitle, and sound options. * **Display Prompts**: Show interactive dialog prompts to gather user input, with optional buttons, icons, and default answers. * **Text-to-Speech**: Utilize macOS text-to-speech to speak text, with customizable voice and speech rate. * **Take Screenshots**: Capture screenshots of fullscreen, window, or selection areas, with options for format, cursor visibility, and shadow. * **File Selection**: Open native macOS file picker dialogs to select files, with support for multiple selections and file type filters.

Which integrations are available for this server?

Provides access to [Apple](/mcp/servers/integrations/apple)'s macOS system services including notifications, dialogs, text-to-speech, screenshot capture, and file selection functionality. Enables sending native [macOS](/mcp/servers/integrations/macos) notifications, displaying interactive dialog prompts, using text-to-speech capabilities, capturing screenshots, and accessing the native file picker dialog.

The Apple Notifier MCP Server enables interaction with macOS system features through MCP-compatible clients:

Send Notifications: Display native macOS notifications with customizable title, message, subtitle, and sound options.
Display Prompts: Show interactive dialog prompts to gather user input, with optional buttons, icons, and default answers.
Text-to-Speech: Utilize macOS text-to-speech to speak text, with customizable voice and speech rate.
Take Screenshots: Capture screenshots of fullscreen, window, or selection areas, with options for format, cursor visibility, and shadow.
File Selection: Open native macOS file picker dialogs to select files, with support for multiple selections and file type filters.

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)

Related MCP server: Toast MCP Server

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.

Running evals

The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts

License

MIT License - see the LICENSE file for details.

apple-notifier-mcp

Apple Notifier MCP Server

Prerequisites

Installation

Installing via Smithery

Manual Installation

Features

Send Notifications

Display Prompts

Text-to-Speech

Take Screenshots

File Selection

Example Usage

Contributing

Running evals

License

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API