Message MCP
Supports sending email notifications through Gmail's SMTP server when AI tasks are completed
Provides native system notifications for Linux environments when AI tasks are complete
Delivers native system notifications for macOS when AI tasks are complete
Compatible with Ubuntu's default notification system for displaying alerts when AI tasks finish
Click on "Deploy 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., "@Message MCP notify me when the data analysis is complete"
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.
🚀 Boost AI efficiency and free up more time
When waiting for AI to complete tasks, do you wish you could handle other work simultaneously? Now you can confidently take care of other matters while AI executes long-running tasks.
Message MCP makes your AI collaboration more efficient!
🧑: Make a Tetris web game, notify when completed.
🤖: I'll start making the Tetris game
...
💬: Message MCP executed, message sent.Allow MCP auto-execution in client settings.
Add "notify when completed" prompts in user rules or rule files to avoid repetitive manual prompts.
⚡️ Quick Installation
Supports cloud installation via smithery.ai (e.g., SaaS services like Dify) and offers one-click local deployment. Since the Message MCP actually runs on smithery.ai’s cloud, desktop notifications are not yet supported. End-to-end encryption is applied throughout to ensure data security. Learn more
⚙️ Standard Installation
MacOS, Linux, WSL2
{
"mcpServers": {
"message-mcp": {
"command": "npx",
"args": ["-y", "message-mcp@latest"]
}
}
}Windows
{
"mcpServers": {
"message-mcp": {
"command": "cmd",
"args": ["/c", "npx", "-y", "message-mcp@latest"]
}
}
}🎛️ Optional Configuration
Modify Desktop Notifications
{
"mcpServers": {
"message-mcp": {
"command": "npx",
"args": ["-y", "message-mcp@latest"],
"env": {
"DISABLE_DESKTOP": "true",
"SOUND_PATH": "/path/to/your/sound.mp3"
}
}
}
}
Desktop notifications are enabled by default
Default sound provided by zapsplat. If you don't like the default sound, you can download and configure from zapsplat.com.
ntfy Mobile Notifications
Install App: App Store, Google Play, F-Droid
{
"mcpServers": {
"message-mcp": {
"command": "npx",
"args": ["-y", "message-mcp@latest"],
"env": {
"NTFY_TOPIC": "your-unique-topic"
}
}
}
}Email Notifications
{
"mcpServers": {
"message-mcp": {
"command": "npx",
"args": ["-y", "message-mcp@latest"],
"env": {
"SMTP_HOST": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_SECURE": "false",
"SMTP_USER": "user@gmail.com",
"SMTP_PASS": "your_password"
}
}
}
}API Notifications
{
"mcpServers": {
"message-mcp": {
"command": "npx",
"args": ["-y", "message-mcp@latest"],
"env": {
"API_URL": "https://httpbin.org/post",
"API_METHOD": "POST", // POST, PUT, PATCH
"API_HEADERS": "{\"Authorization\": \"Bearer token\"}"
}
}
}
}fetch(API_URL, {
method: API_METHOD,
headers: {
'Content-Type': 'application/json'
...JSON.parse(API_HEADERS)
},
body: JSON.stringify({
title: notifyTitle,
message: notifyMessage,
}),
})Related MCP server: mcp-notifications
📌 System Requirements
Node.js: 18 or higher
macOS: Native notifications require >= 10.8
Linux: notify-osd or libnotify-bin installed (Ubuntu includes by default)
Windows: >= 8, or taskbar balloon notifications for Windows < 8
❗️ Troubleshooting
Windows System Notifications Not Enabled
Settings > Notifications & actions > Get notifications from apps and other senders → Enable
WSL2 (Ubuntu) has no notification sound
sudo apt install -y pulseaudio mpg123WSL2 Environment Missing OS Notifications
sudo find / -type f -name "snoretoast-*.exe" 2>/dev/null
/path/to/.../node_modules/snoretoast-x64.exe
/path/to/.../node_modules/snoretoast-x86.exe
chmod +x /path/to/.../node_modules/snoretoast-*.exeIf this project is helpful to you, please give it a ⭐️ to support it and let more people see it!
Available Tools
1 toolnotifySend Message NotificationA
Send notifications and messages through multiple channels (desktop, email, API). Use this tool to notify users about any important information, progress updates, task completions, alerts, or any other communication needs.
Inputs: title, message.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so no possibility of confusion or overlap.
Single tool uses a clear, verb-based name 'notify' which is consistent with its purpose.
One tool for a notification domain is too few; typically multiple operations (e.g., send, schedule, manage templates) are needed.
The tool sends notifications but lacks capabilities for managing channels, templates, logs, or preferences, leaving significant gaps.
Maintenance
Related MCP Connectors
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Generate AI images, video, and audio with many frontier models, private by default.
Generate video, images, speech and music with 120+ AI models and render TSX videos to MP4
Generate images, videos, music & lip sync with 200+ AI models (Flux, Veo 3, Kling, Suno)
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol service that sends desktop notifications and alert sounds when AI agent tasks are completed, integrating with various LLM clients like Claude Desktop and Cursor.154MIT
- AlicenseNot gradedqualityDmaintenanceEnables sending real-time and webhook notifications when AI agents complete tasks, with support for Discord, Slack, Teams, Feishu, Ntfy, and custom webhooks.6MIT
- AlicenseBqualityDmaintenanceEnables AI development tools on Windows to send native system notifications for task completion, errors, and reminders, with customizable icons and sounds.724 npm8MIT
- AlicenseBqualityDmaintenanceAn MCP server that lets LLM agents dispatch native OS notifications when a task finishes. It supports cross-platform desktop notifications, task tokens for updates, mobile bridges, and quiet hours.2MIT