Telegram Notification MCP Server

@kstonekuan

About Telegram Notification MCP Server

Simple MCP server to send you notifications on telegram

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

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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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.

Frequently asked questions

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

Basic information

More Communication MCP servers

Outlook MCP Server

Wallisking1991

mcp-email-server

ai-zerolab

IMAP and SMTP via MCP Server

270

Slack

modelcontextprotocol

Model Context Protocol Servers

88.1K

Telegram MCP Server

kfastov

Telegram user console client and archiver

Email sending MCP 💌

ykhli

The official MCP server to send emails and interact with Resend

549