Skip to main content
Glama
Sign In
telegram-notification-mcp

telegram-notification-mcp

by discountry
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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)

Related MCP server: Telegram Notifier MCP Server

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!"
    }
  }
}

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers