Reminder MCP Server

A minimal MCP server that plays a short notification sound and waits for a specified number of seconds.

Features

• Plays a sound when the tool is called, then waits N seconds
• Plays a sound on server startup
• Cross-platform sound attempts (Windows/macOS/Linux) with graceful fallbacks

Tool

• Name: reminder
• Input:
  • seconds (integer, optional, default 5) — how many seconds to wait

Install

npm install
npm run build

Run

npm start

The server runs over stdio, suitable for MCP hosts.

Quick install via NPX

You can configure MCP hosts (e.g., Claude Desktop or VS Code) to run this server via npx without cloning the repo.

Claude Desktop

Add to your claude_desktop_config.json:

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

VS Code MCP

User configuration (mcp.json):

{
  "servers": {
    "reminder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-reminder"
      ]
    }
  }
}

Environment

• MCP_REMINDER_SILENT=1 — disable sounds (useful for CI or silent environments)

Notes

• Windows: tries PowerShell/MessageBeep first, then falls back to ASCII bell
• macOS: tries afplay/say
• Linux: tries canberra-gtk-play, paplay, or aplay, then falls back