Provides tools to send native macOS system notifications with customizable titles, messages, and types, supporting features like automatic project detection and notification logging.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-macos-utilssend a success notification that the build finished"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-macos-utils
A Model Context Protocol (MCP) server that provides macOS utility tools for AI assistants.
Features
Native macOS Notifications: Send system notifications with different types (success, error, info, warning)
Auto Project Detection: Automatically detects and includes the current project name in notifications
Notification Logging: All notifications are logged to
~/.mcp-notifications.logfor audit trailTypeScript Support: Fully typed for better development experience
Installation
Clone this repository:
Run the install script:
This will:
Install npm dependencies
Build the TypeScript code
Create an example configuration file
Configuration
Add the following to your MCP client's configuration file:
Replace /absolute/path/to/mcp-macos-utils with the actual path to this directory.
Usage
Once configured, the following tool will be available to AI assistants:
notify
Send a macOS notification with project context.
Parameters:
title(required): The notification titlemessage(required): The notification messagetype(optional): Type of notification -success,error,info, orwarning(default:info)sound(optional): Whether to play a sound (default:true)subtitle(optional): Custom subtitle (defaults to current project name)
Example:
Notification Types
Success (✅): For successful operations
Error (❌): For errors or failures
Warning (⚠️): For warnings or cautions
Info (ℹ️): For general information
Logging
All notifications are logged to ~/.mcp-notifications.log in JSON format, including:
Timestamp
Project name
Notification type
Title and message
Any errors that occurred
Development
Building
Development Mode
Clean Build
Requirements
macOS (uses native
osascriptfor notifications)Node.js 20+
TypeScript 5.5+
License
MIT