Macos Notifier

🚀 Apple_notifier MCP Server

Send native macOS notifications and interact with system dialogs via any compatible MCP client (e.g., Claude Desktop or Cline).

🚀 Quick Start

To use the Apple_notifier MCP Server, you need to meet the following prerequisites and follow the installation steps.

✨ Features

Send Notifications

Display native macOS notifications with customizable content.

Parameter Explanation:

• title (Required): String - The title of the notification.
• message (Required): String - The main message content.
• subtitle (Optional): String - The subtitle to be displayed.
• sound (Optional): Boolean - Whether to play the default alert sound (Default: true).

Show Prompt Box

Present an interactive dialog to get user input.

Parameter Explanation:

• message (Required): String - The text to be displayed in the prompt box.
• defaultAnswer (Optional): String - The preset default answer.
• buttons (Optional): Array of strings - Custom button labels (maximum 3).
• icon (Optional): 'note' | 'stop' | 'caution' - The icon to be displayed.

Text-to-Speech

Utilize macOS's text-to-speech function.

Parameter Explanation:

• text (Required): String - The text to be played.
• voice (Optional): String - The voice to be used (default is the system voice).
• rate (Optional): Number - The speaking rate (range: -50 to 50, default: 0).

Screen Capture

Capture the screen using macOS's screencapture tool.

Parameter Explanation:

• path (Required): String - The path to save the screenshot.
• type (Required): 'fullscreen' | 'window' | 'selection' - The type of screenshot.
• quality (Optional): Number - The image quality (range: 0 to 100).
• format (Optional): 'png' | 'jpeg' - The image format.

Prompt to Select Files

Show a dialog to allow the user to select files.

Parameter Explanation:

• multiple (Optional): Boolean - Whether to allow multiple file selection.
• accept (Optional): Array of strings - The file type filters to accept.

📦 Installation

Automatic Installation with Smithery

Automatically install Apple_notifier for Claude Desktop via Smithery:

npx -y @smithery/cli install apple-notifier-mcp --client claude

Manual Installation

1. Install the package globally:

npm install -g apple-notifier-mcp

2. Add it 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"
    }
  }
}

💻 Usage Examples

Basic Usage

// Send a notification
new Notification({
  title: "Reminder",
  message: "You have a new message.",
  sound: true
});

// Show a prompt box
Dialog.prompt({
  message: "Please enter your name:",
  defaultText: "Zhang San"
}).then(name => {
  console.log(`The user entered the name: ${name}`);
});

// Text-to-speech
Speech.speak("Hello, this is a test message.", { 
  voice: 'zh-CN',
  rate: 1.5 
});

// Screen capture
ScreenCapture.capture('selection', '/Users/username/Desktop/screenshot.png');

// Prompt to select files
FilePicker.show({
  multiple: true,
  accept: ['image/*']
}).then(files => {
  console.log(`The user selected ${files.length} files.`);
});

🤝 Contributing

Please refer to CONTRIBUTING.md for setting up the development environment and contribution guidelines.

📄 License

This project is under the MIT License. For details, please refer to the LICENSE file.