Server Notify

v1.0.0Monitoring & Observabilitystable

Send system notification when Agent task is done.

mcpmcp-servernotification
Share:
52
Stars
0
Downloads
0
Weekly
0/5

What is Server Notify?

Server Notify is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to send system notification when agent task is done.

Send system notification when Agent task is done.

This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Send system notification when Agent task is done.

Use Cases

Get system notifications when agent tasks finish executing.
Cactusinhand

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-server-notify

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Server Notify

MCP Server Notify is a lightweight MCP server that sends desktop system notifications and plays an alert sound when an AI agent finishes a long-running task. It uses the Apprise API to deliver cross-platform notifications on Windows, macOS, and Linux, so you can step away from your desk while Claude works and be alerted the moment the task completes. It is especially useful for slow operations like code generation, batch processing, or multi-step research tasks.

Prerequisites

  • Python 3.8+ and pip (or uv) installed
  • Platform-specific notification support: pywin32 on Windows, terminal-notifier on macOS (brew install terminal-notifier), or a standard notification daemon on Linux
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install platform notification dependencies

Install the OS-level notification support for your platform before installing the Python package.

# macOS
brew install terminal-notifier

# Windows (in your Python environment)
pip install pywin32
2

Install the mcp-server-notify package

Install the package using pip or uv. The uvx approach is convenient for VS Code and Cursor.

pip install mcp-server-notify
# or with uv
uv pip install mcp-server-notify
3

Verify the installation

Confirm the server module can be loaded by running it directly.

python -m mcp_server_notify
4

Add the server to your MCP client configuration

Edit your MCP client config to include the notification server. Use the python -m invocation for Claude Desktop or the uvx form for VS Code.

5

Instruct the agent to notify on task completion

When starting a long task, tell Claude to send a notification when it finishes. Add the instruction to your prompt.

Server Notify Examples

Client configuration

Claude Desktop configuration using the python -m invocation. For VS Code with Copilot, use uvx instead.

{
  "mcpServers": {
    "NotificationServer": {
      "command": "python",
      "args": ["-m", "mcp_server_notify"]
    }
  }
}

Prompts to try

How to ask Claude to send you a notification after completing a task.

- "Refactor all the API endpoints in this project and send me a system notification when you're done"
- "Run the full test suite analysis and notify me when complete"
- "Generate documentation for every public function in this module, then send a desktop notification"
- "When you finish the task, send me a notification with a brief summary"

Troubleshooting Server Notify

No notification appears on macOS

Ensure terminal-notifier is installed (brew install terminal-notifier) and that your terminal application has notification permissions in System Settings > Notifications.

No notification appears on Windows

Install the pywin32 package in the same Python environment used to run the server: pip install pywin32. Restart your Python environment after installation.

Server fails to start with import errors

Make sure you are running the correct Python interpreter that has mcp-server-notify installed. Use 'which python' or 'python --version' to confirm the right environment is active.

Frequently Asked Questions about Server Notify

What is Server Notify?

Server Notify is a Model Context Protocol (MCP) server that send system notification when agent task is done. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Server Notify?

Follow the installation instructions on the Server Notify GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Server Notify?

Server Notify works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Server Notify free to use?

Yes, Server Notify is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Monitoring & Observability MCP Servers

Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-server-notify": { "command": "npx", "args": ["-y", "mcp-server-notify"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Server Notify?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides