A
securityF
licenseA
qualityMCP server that enables reading and writing macOS system preferences and application settings through the defaults system.
Last updated -
4
11
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.
Provides access to Apple's macOS system services including notifications, dialogs, text-to-speech, screenshot capture, and file selection functionality.
Enables sending native macOS notifications, displaying interactive dialog prompts, using text-to-speech capabilities, capturing screenshots, and accessing the native file picker dialog.
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)
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 notificationmessage(required): string - The main message contentsubtitle(optional): string - A subtitle to displaysound(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 dialogdefaultAnswer(optional): string - Default text to pre-fillbuttons(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 speakvoice(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 screenshottype(required): 'fullscreen' | 'window' | 'selection' - Type of screenshotformat(optional): 'png' | 'jpg' | 'pdf' | 'tiff' - Image formathideCursor(optional): boolean - Whether to hide the cursorshadow(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 messagedefaultLocation(optional): string - Default directory pathfileTypes(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.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that displays desktop notifications on Windows 10 and macOS, compatible with VSCode Cline and supporting customizable notification parameters.Last updated -3MIT License
- -securityAlicense-qualityA macOS app that provides an MCP server to your Messages, Contacts, and moreLast updated -947MIT License
- -securityFlicense-qualityA simple MCP server implementation that demonstrates streaming capabilities with tools for greetings and notifications, accessible through an interactive command-line client.Last updated -1