notify-completion

The notify-completion MCP server provides a lightweight task completion notifier. It integrates with clients that support MCP configurations (such as Cline, Claude Desktop, Cursor, or other compatible tools) to monitor the execution time of long-running AI tasks and trigger a user notification when tasks complete or exceed a specified threshold. By configuring the MCP server, you can start a timer at task initiation and then check whether the task is overdue; if overdue, a user-defined command executes (for example displaying a desktop notification or playing a sound). This empowers you to multitask without constantly watching your task status. To use it, set up the MCP server in your client configuration, supply an overdue command via OVERDUE_COMMAND, and ensure the client is configured to auto-approve the MCP tools so the timer and overdue checks can run automatically. The tools exposed are start-timer to begin tracking time, and check-overdue to determine if the task has exceeded the allowed duration.

Prerequisites:

• Node.js and npm installed on your system.
• Access to the npm registry (public or private as configured).

Installation steps:

1. Prepare your client configuration file (e.g., cline_mcp_settings.json) and add the MCP server block as shown:

{
  "mcpServers": {
    "notify-completion": {
      "command": "npx",
      "args": ["-y", "@nakat-t/notify-completion-mcp-server@latest"],
      "env": {
        "OVERDUE_COMMAND": "<Command to execute when the task is overdue/complete>",
        "EXECUTE_IN_SERVER": "<true|false>"
      },
      "autoApprove": [ "start-timer", "check-overdue" ]
    }
  }
}

2. Install and start using the MCP server via npx as configured above. The package will be fetched from npm and loaded by your client runtime.

3. Customize environment variables:

• OVERDUE_COMMAND: the command to run when the task is overdue or completed (e.g., a desktop notification command).
• EXECUTE_IN_SERVER: if using Claude Desktop, set to "true" to execute inside the MCP server; otherwise omit or set to false.

4. Ensure your client is configured to auto-approve the MCP tools so the start-timer and check-overdue steps execute without user intervention.

Notes and tips:

• OVERDUE_COMMAND controls what happens when a task is complete or overdue. Use a notification command suitable for your OS (e.g., display notification, play a sound).
• If you are using Claude Desktop, you may set EXECUTE_IN_SERVER to true, which changes where the overdue command runs.
• The MCP tools exposed are:
  • start-timer: returns a startTime in ISO format to mark when the task began.
  • check-overdue: compares elapsed time against a threshold; if overdue, it returns a command to run via OVERDUE_COMMAND.
• For best results, keep your environment variables and auto-approve settings in sync across client configurations to prevent prompts during automation.
• This MCP server is ideal for notifying you about long-running AI tasks so you can proceed with other work without manual monitoring.