notify-completion-mcp-server

Name: notify-completion-mcp-server
Author: nakat-t

@nakat-t

About notify-completion-mcp-server

The MCP server that provides notifications when AI agents complete long-running tasks. This allows you to leave your desktop without forgetting about tasks.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notify-completion": {
      "command": "npx",
      "args": [
        "-y",
        "@nakat-t/notify-completion-mcp-server@latest"
      ],
      "env": {
        "OVERDUE_COMMAND": "<Command to execute very flashy effects>"
      },
      "autoApprove": [
        "start-timer",
        "check-overdue"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is notify-completion-mcp-server?

The MCP server that provides notifications when AI agents complete long-running tasks, allowing users to leave their desktop without forgetting about tasks. It addresses the issue of users needing to actively monitor their computer for AI task completion by providing a notification mechanism triggered when tasks are finished.

How to use notify-completion-mcp-server?

Add the server configuration to your MCP client settings (e.g., cline_mcp_settings.json) using npx, set the OVERDUE_COMMAND environment variable, optionally configure THRESHOLD and EXECUTE_IN_SERVER, and paste the provided custom instructions into your client settings to direct AI agents to call the start-timer and check-overdue tools.

Key features of notify-completion-mcp-server

Provides notifications when AI agents complete long-running tasks
Offers two MCP tools: start-timer and check-overdue
Configurable overdue command for custom notifications
Supports adjustable threshold to skip short tasks
Works with Cline, Claude Desktop, Cursor, and GitHub Copilot

Use cases of notify-completion-mcp-server

Receive a desktop notification when an AI agent finishes a complex data analysis
Get alerted when code generation or large refactoring completes
Be notified when batch processing or file transformations finish
Walk away from your desk while AI performs a long task and get notified upon completion

FAQ from notify-completion-mcp-server

Which MCP clients are confirmed to work with notify-completion-mcp-server?

Cline, Claude Desktop, Cursor, and GitHub Copilot have been confirmed to work. Other clients likely work if they have similar capabilities.

What environment variables does notify-completion-mcp-server require?

OVERDUE_COMMAND is required. THRESHOLD (default 0 seconds) and EXECUTE_IN_SERVER are optional.

How does the timer notification mechanism work?

The AI agent calls start-timer at the beginning of a task and check-overdue when the task completes. If elapsed time exceeds the threshold, the server returns the configured command for notification.