💬 Message MCP

🌐 Available in: 中文 | 한국어 | 日本語

Real-time push notifications and alert sounds free you from staring at the screen. While the AI works, you can comfortably enjoy a cup of coffee.

🤔 Why Message MCP?

Are you still working like this?

• 👀 Staring at the progress bar waiting for AI to generate code
• 🔄 Constantly switching windows to check if ChatGPT has finished replying
• ⏳ Afraid to leave your seat while Cursor, Copilot, Claude Code and more are running

Message MCP solves this problem!

✨ Features

• 💬 Instant Notifications: Automatically pops up desktop notifications when AI tasks are done
• 🔔 Sound Alerts: Audio reminders so you never miss any important progress
• 📧 Email Notifications: Support for sending email notifications via SMTP
• 🧩 Webhook Support: Send notifications to custom URL endpoints

💡 Usage

👤 You: Make a Tetris web game. Notify me when done.
🤖 AI: I'll start making the Tetris game...

MacOS / Linux

{
  "mcpServers": {
    "message-mcp": {
      "command": "npx",
      "args": ["message-mcp@latest"]
    }
  }
}

Windows

{
  "mcpServers": {
    "message-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "message-mcp@latest"]
    }
  }
}

Email Notification Setup (Optional)

If you want to use email notifications, add the SMTP URL configuration parameter to the args array:

{
  "mcpServers": {
    "message-mcp": {
      "command": "npx",
      "args": [
        "message-mcp@latest",
        "--smtp-url=smtp://your-email@gmail.com:your-app-password@smtp.gmail.com:587"
      ]
    }
  }
}

Common SMTP URL Examples:

• Gmail: smtp://user:pass@smtp.gmail.com:587
• Outlook: smtp://user:pass@smtp-mail.outlook.com:587
• Yahoo: smtp://user:pass@smtp.mail.yahoo.com:587
• QQ Mail: smtps://user:pass@smtp.qq.com:465

Webhook Notification Setup (Optional)

If you want to use webhook notifications, add the webhook URL configuration parameter:

{
  "mcpServers": {
    "message-mcp": {
      "command": "npx",
      "args": [
        "message-mcp@latest",
        "--webhook-url=https://your-webhook-endpoint.com/notify"
      ]
    }
  }
}

📌 System Requirements

• 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 Disabled

Settings > Notifications & actions > Get notifications from apps and other senders → Enable

WSL2 Environment Missing OS Notifications

sudo find / -type f -name "snoretoast-*.exe" 2>/dev/null
[node_modules_path]/snoretoast-x64.exe
[node_modules_path]/snoretoast-x86.exe

chmod +x [node_modules_path]/snoretoast-*.exe