
MCP Notifier
Send desktop notifications easily with customizable settings and various notification types. Enhance your applications with simple and advanced notification capabilities to keep users informed and engaged.
Installation
Installing for Claude Desktop
Option 1: One-Command Installation
npx mcpbar@latest install uehaj/mcp-notifier -c claude
This command will automatically install and configure the MCP Notifier MCP server for your selected client.
Option 2: Manual Configuration
Run the command below to open your configuration file:
npx mcpbar@latest edit -c claude
After opening your configuration file, copy and paste this configuration:
View JSON configuration
{
"mcpServers": {
"MCP Notifier": {
"command": "npx",
"args": [
"@uehaj/mcp-notifier"
]
}
}
}
MCP Notifier
A Model Context Protocol (MCP) server that provides desktop notification capabilities using node-notifier.
Features
- Simple notification tool
- Advanced notification tool with additional options
- Support for different notification types (info, success, warning, error)
- Customizable notification settings
Platform Support
This MCP server uses node-notifier and works across multiple platforms:
- macOS: Uses macOS Notification Center
- Windows: Uses Windows Toast Notifications (Windows 8+) or taskbar balloons (< Windows 8)
- Linux: Uses notify-send command for Gnome/Ubuntu notifications
For more details on platform-specific behavior, visit the node-notifier documentation.
Usage Options
You can use MCP Notifier in two ways:
Option 1: Run Directly with npx
The simplest way to use MCP Notifier is with npx:
# Run directly with npx
npx @uehaj/mcp-notifier
This will download and execute the package with a single command.
Option 2: Clone and Build from Source
# Clone repository
git clone https://github.com/uehaj/mcp-notifier.git
cd mcp-notifier
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
node build/index.js
Integration with Claude Desktop
-
Edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Choose one of the following configuration methods:
For npx method (recommended):
{
"mcpServers": {
"mcp-notifier": {
"command": "npx",
"args": [
"@uehaj/mcp-notifier"
]
}
}
}
For local git clone method:
{
"mcpServers": {
"mcp-notifier": {
"command": "node",
"args": [
"/absolute/path/to/cloned/mcp-notifier/build/index.js"
]
}
}
}
- Restart Claude Desktop
Smithery Integration
This MCP server is available on Smithery. Since it requires desktop access to function properly, it must be installed locally rather than used as a hosted service.
Run via Smithery CLI:
# Run using Smithery CLI
npx @smithery/cli run @uehaj/mcp-notifier
Manual setup from repository:
Follow the "Clone and Build from Source" instructions above.
Available Tools
notify
Basic notification tool with the following parameters:
title
: The notification title (required)message
: The notification message (required)icon
: Optional path to an icon filesound
: Whether to play a sound (optional boolean)wait
: Whether to wait for the notification to close (optional boolean)
notify-advanced
Advanced notification tool with more options:
title
: The notification title (required)message
: The notification message (required)type
: Notification type - "info", "success", "warning", or "error" (optional)timeout
: Auto-close timeout in milliseconds (optional)closeLabel
: Text for close button (macOS only, optional)actions
: Array of action button labels (macOS only, optional)
Testing
Run tests:
# For npx method
npx @modelcontextprotocol/inspector npx @uehaj/mcp-notifier
# For git clone method
cd mcp-notifier
npx @modelcontextprotocol/inspector node build/index.js
Development
Publishing to npm
The package includes several npm scripts to help with publishing:
# Publish the current version
npm run release
# Increment patch version (1.0.0 -> 1.0.1) and publish
npm run release:patch
# Increment minor version (1.0.0 -> 1.1.0) and publish
npm run release:minor
# Increment major version (1.0.0 -> 2.0.0) and publish
npm run release:major
These commands will:
- Automatically run the build process
- Update the version number as needed
- Publish the package to npm with public access
You need to be logged in to npm (npm login
) before running these commands.
Requirements
- Node.js 18 or higher
- npm 6 or higher
- Desktop environment (Windows, macOS, or Linux)
- Access permissions to notification system
License
MIT
Stars
1Forks
0Last commit
3 months agoRepository age
3 months
Auto-fetched from GitHub .
MCP servers similar to MCP Notifier:

Stars
Forks
Last commit

Stars
Forks
Last commit

Stars
Forks
Last commit