artemeey avatar

Mcp Notifications

artemeey/mcp-notifications

Adds a send_notification tool that fires native desktop notifications from your MCP agent over stdio. Useful when you're running console agents like Codex or Claude and want async feedback without polling the chat. You control title, message, sound on/off, and optional icon path. Supports node-notifier on most platforms and can force PowerShell toasts in WSL via environment variable. The main workflow is instructing your agent to notify you after long tasks or failures, either manually per request or by baking it into project-level instructions. Returns immediately while notifications queue in the background.

GitHub stars
2
tool
1
transport
STDIO
last updated
Feb 17, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

send_notificationSends a desktop notification with a title and message, optionally with sound, icon and app_id.

Sends a desktop notification with a title and message, optionally with sound, icon and app_id.

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-notifications

npm version

🚀 Ship faster. Miss nothing.

mcp-notifications lets your MCP agent send desktop notifications for completed tasks, failures, and important updates.

This is especially useful for console AI agents, because they usually have no built-in notifications by default.

No more checking chats every minute.
No more silent agent responses.
Just visible, reliable feedback on your desktop. 🔔

Common problem this solves

You give tasks to several AI agents, then wait and keep checking who already replied.

With mcp-notifications, this gets simpler: the agent can notify you on desktop when it needs your input or when work is done.

Why teams install this

  • ⚡ Immediate feedback from your MCP workflows.
  • 🧠 Better focus: let the agent work while you stay on your main task.
  • 🖥️ Native OS notifications via node-notifier.
  • 🧵 Non-blocking behavior: notification sending is queued in background.

Install globally

Requirements:

  • Node.js >=20
  • npm >=10
npm i -g @topvisor/mcp-notifications

View the full README on GitHub

Details

Repository
github.com/artemeey/mcp-notifications
Package
@topvisor/mcp-notifications
Transport
STDIO
Registry
MCP registry, active