MCP Notifications Server

Exposes a single MCP tool to show native macOS notifications via the macOS Notification Center.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "konstzv-mcp-notifications": {
      "command": "node",
      "args": [
        "/Users/konstantinzagulin/IdeaProjects/mcp-notifications/build/index.js"
      ]
    }
  }
}

You run an MCP server that lets clients display native macOS notifications through the macOS Notification Center. This server provides a single tool to show notifications with customizable title, content, and optional icon or sound, making it easy to trigger system alerts from your MCP-enabled apps or assistants.

How to use

To display macOS notifications from an MCP client, run the server locally and connect your MCP client (for example, Claude Desktop) to the provided stdio endpoint. You configure the client to start the server process and then invoke the show_notification tool with your desired parameters to display a native notification.

Configure your MCP client to use the server’s stdio endpoint by pointing it to the runtime command and script path shown below. The server exposes the show_notification tool and accepts a title, content, and optional icon and sound. When you trigger the tool from your MCP client, the server displays a macOS notification.

How to install

Prerequisites you need before install are the following.

# Prerequisites
node -v  # should be v18 or later
npm -v   # or yarn -v

# Step 1: Install dependencies
npm install

# Step 2: Build the TypeScript code
npm run build

Additional content

The server is designed for macOS and uses the macOS Notification Center to present notifications. If you are setting up Claude Desktop, you will integrate the server by configuring the MCP client to start the stdio process and then call the show_notification tool with your desired parameters.

Example of how the server is wired for Claude Desktop (config path and exact path to the built script will vary for your setup). The client will spawn the Node process that runs the built script, which in turn handles the show_notification tool.

Example usage with the tool

To show a simple notification, provide a title and content to the show_notification tool via your MCP client. Optional parameters let you specify an icon or a system sound.

# Example invocation from an MCP client
# Title: Task Complete
# Content: Your build finished successfully
# icon: optional path to an icon file
# sound: optional system sound name

Available tools

show_notification

Displays a macOS notification with a title and content, with optional icon and sound, via the macOS Notification Center.