macOS Utilities

by msageryd

Not rated
GitHub

About

Provides macOS utility tools for AI assistants, including sending native notifications with project context.

Details

Author
msageryd
Categories
Productivity, Other

Setup

Install macOS Utilities in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/msageryd/mcp-macos-utils

Follow the installation instructions in the repository README, then restart your MCP client.

Provides macOS utility tools for AI assistants, including sending native notifications with project context.

A Model Context Protocol (MCP) server that provides macOS utility tools for AI assistants.

- 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 trail
- TypeScript Support: Fully typed for better development experience

git clone <repository-url> cd mcp-macos-utils

- Install npm dependencies
- Build the TypeScript code
- Create an example configuration file

Add the following to your MCP client's configuration file:

{ "mcpServers": { "macos-utils": { "command": "node", "args": ["/absolute/path/to/mcp-macos-utils/dist/index.js"], "env": {} } } }

Replace/absolute/path/to/mcp-macos-utilswith the actual path to this directory.

Once configured, the following tool will be available to AI assistants:

Send a macOS notification with project context.

- title(required): The notification title
- message(required): The notification message
- type(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)

await notify({ title: "Build Complete", message: "Your project has been built successfully", type: "success" });

- Success(✅): For successful operations
- Error(❌): For errors or failures
- Warning(⚠️): For warnings or cautions
- Info(ℹ️): For general information

All notifications are logged to~/.mcp-notifications.login JSON format, including:

- Timestamp
- Project name
- Notification type
- Title and message
- Any errors that occurred

- macOS (uses nativeosascriptfor notifications)
- Node.js 20+
- TypeScript 5.5+

Trigger macOS notifications, sounds, and text-to-speech from an AI assistant.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

On-device tools to detect AI-generated text and images, score readability, and strip AI artifacts, running locally on Apple silicon.

Interact with Apple Notes using natural language on macOS.

Free local MCP server for Apple Mail, Calendar, and Reminders on macOS.

A server for native integration with Apple Reminders on macOS.

Execute AppleScript to gain full control of your Mac.

Native macOS Calendar & Reminders MCP server with 24 tools using Swift EventKit - supports recurring events, location triggers, search, batch operations

Native macOS Calendar & Reminders MCP server via Apple EventKit — events, reminders, recurrence, location triggers, conflict checks, and batch ops across iCloud/Google/Exchange.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.