telegram-notification-mcp

A minimal Telegram notification MCP server using only native Node.js APIs.

Requirements

• Node.js >= 18.0.0
• Telegram Bot Token (get from @BotFather)
• Telegram Chat ID (your chat ID or channel ID)

Quick Start

Add the Telegram notification MCP server using the claude mcp add command:

claude mcp add --transport stdio telegram-notification --scope user \
  --env TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN \
  --env TELEGRAM_CHAT_ID=YOUR_CHAT_ID \
  -- npx -y telegram-notification-mcp

Replace YOUR_BOT_TOKEN and YOUR_CHAT_ID with your actual Telegram bot token and chat ID.

Manual Setup

If you prefer to configure manually, add to your MCP configuration (e.g., ~/.cursor/mcp.json or Claude Desktop settings):

{
  "mcpServers": {
    "telegram-notification": {
      "command": "npx",
      "args": ["telegram-notification-mcp@latest"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "YOUR_TELEGRAM_BOT_TOKEN",
        "TELEGRAM_CHAT_ID": "YOUR_TELEGRAM_CHAT_ID"
      }
    }
  }
}

Local Development

For local development, use an absolute path:

{
  "mcpServers": {
    "telegram-notification": {
      "command": "node",
      "args": ["/absolute/path/to/telegram-notification-mcp/index.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "YOUR_TELEGRAM_BOT_TOKEN",
        "TELEGRAM_CHAT_ID": "YOUR_TELEGRAM_CHAT_ID"
      }
    }
  }
}

Tools

send_notification

Send a notification message to Telegram.

Parameters:

• message (string, required): The message to send

Example:

{
  "method": "tools/call",
  "params": {
    "name": "send_notification",
    "arguments": {
      "message": "Hello, World!"
    }
  }
}