Skip to content
MCP Server Directory logo
automation-scripting

Message Mcp

Desktop notifications, custom sounds, ntfy mobile notifications, email notifications, and API pushes reduce anxiety while waiting for AI tasks, allowing you to comfortably enjoy a cup of coffee.

Reviewed overview

MCP 服务器概览

What is the project about? Message MCP is a notification bridge for AI workflows (MCP servers). It sends desktop notifications, custom sounds, ntfy mobile alerts, email notifications, and API pushes when AI tasks complete, so you can stop watching long-running jobs and do other work.

How to use the project?

  • Quick install via npx or one-click through providers like smithery.ai or Cursor integrations. Typical install uses an MCP server entry that runs npx -y message-mcp@latest.
  • Configure behavior via environment variables in your MCP server config (examples provided): disable desktop notifications, set SOUND_PATH, set NTFY_TOPIC for mobile, set SMTP_* for email, or set API_URL/API_METHOD/API_HEADERS for HTTP pushes.
  • System requirements: Node.js 18+, OS notification support (macOS >=10.8, Windows >=8, Linux with libnotify or notify-osd).

Key features

  • Desktop notifications with optional custom sound
  • Mobile notifications via ntfy
  • Email notifications via SMTP
  • Generic API/Webhook pushes (POST/PUT/PATCH) with custom headers
  • Works as an MCP server integration (one-click cloud or local deploy)
  • End-to-end encryption for data in transit
  • Cross-platform support with troubleshooting steps for WSL2/Windows

Use cases

  1. Notify developers when long-running AI code generation or model tasks finish.
  2. Alert product owners when automated content generation or batch jobs complete.
  3. Send mobile push or email when CI/automation steps finish via MCP rules.
  4. Integrate with custom dashboards or webhook consumers to trigger downstream workflows.
  5. Improve productivity by freeing users from constantly checking task progress.

FAQ

  • What platforms are supported? Node.js 18+ on macOS, Linux, Windows; desktop notifications require OS notification support and optional helper tools on WSL2.

  • How do I disable desktop notifications or change the sound? Set env vars in the MCP server: DISABLE_DESKTOP=true and SOUND_PATH=/path/to/sound.mp3.

  • How do mobile notifications work? Configure NTFY_TOPIC and use the ntfy app (App Store, Google Play, F-Droid) to receive pushes.

  • How to send email notifications? Configure SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, and related env vars in your MCP server config.

  • How to send custom API notifications? Set API_URL, API_METHOD, and API_HEADERS; the project will POST JSON with title and message (example fetch snippet provided).

  • Troubleshooting tips? Enable system notifications on Windows, install pulseaudio/mpg123 for WSL2 sound, ensure snoretoast executables are executable for Windows notification support.

  • Is it secure? The project uses end-to-end encryption for transfers; when using cloud-hosted MCP (smithery.ai), desktop notifications may be limited in cloud mode.