Telegram Notification MCP Server

Name: Telegram Notification MCP Server
Author: kstonekuan

@kstonekuan

Repository

About Telegram Notification MCP Server

Simple MCP server to send you notifications on telegram

#typescript #telegram #mcp #claude-code #cloudflare-agents

Basic information

Config

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

{
  "mcpServers": {
    "telegram-notification-mcp": {
      "command": "npx",
      "args": [
        "wrangler",
        "secret",
        "put",
        "BOT_TOKEN"
      ]
    }
  }
}

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 Telegram Notification MCP Server?

Telegram Notification MCP Server is an MCP (Model Context Protocol) server that sends notifications to Telegram when Claude Code completes tasks. It is built with TypeScript using the Cloudflare Agents SDK and deployable on Cloudflare Workers.

How to use Telegram Notification MCP Server?

Create a Telegram bot via BotFather, get your chat ID, configure Cloudflare secrets (BOT_TOKEN and optional DEFAULT_CHAT_ID), deploy to Cloudflare Workers, then add the server to Claude Code using the CLI with SSE transport. Usage is through the send_telegram_message tool, which accepts text (required), chat_id (optional), parse_mode (optional), and disable_notification (optional) parameters.

Key features of Telegram Notification MCP Server

MCP tool for sending Telegram notifications
Runs serverless on Cloudflare Workers
Uses Cloudflare secrets for credential security
Supports both SSE and Streamable HTTP transports
Supports Markdown and HTML message formatting

Use cases of Telegram Notification MCP Server

Get notified when Claude Code completes a task
Receive error notifications during execution
Get updates on important milestones
Be alerted when user input or intervention is needed

FAQ from Telegram Notification MCP Server

How do I create a Telegram bot?

Create a bot via BotFather and get your bot token.

How do I get my Telegram chat ID?

Send a message to your bot, then visit https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates to retrieve your chat ID.

What if Telegram notifications are not sent?

Verify that your BOT_TOKEN and DEFAULT_CHAT_ID are correctly set in the worker environment.

What transports does the server support?

It supports both SSE (Server-Sent Events) and Streamable HTTP. Streamable HTTP provides better reliability and is the newer standard.

Is Node.js compatibility required?

Yes, Node.js compatibility mode must be enabled on Cloudflare Workers for this server to function.

Comments

More Communication MCP servers

Telegram MCP server

chaindead

Telegram MCP for managing dialogs, messages, drafts, read statuses, and more.

334

Discord Mcp

SaseQ

A MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.

387