Telegram Notification MCP Server

@kstonekuan

Repository

Basic information

About Telegram Notification MCP Server

Simple MCP server to send you notifications on telegram

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

Telegram Notification MCP Server 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"
      ]
    }
  }
}

Telegram Notification MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

More Communication MCP servers

ViewPrinter

VMGM Software

Schedule and publish social posts to TikTok, Instagram, Facebook, YouTube and X from your AI assistant. Connect an account once, then say what to post and when — ViewPrinter queues it, publishes it, and tells you what ha

Faivelo Email

Benjamin Brookarsh

Business email on your own domain for AI agents. Read, search and send mail, manage mailboxes and aliases, and set up DNS automatically, with unlimited mailboxes on one flat plan.

DashaMail

MCP server for DashaMail email marketing service

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

SocialRobot

socialrobot-io

Schedule and analyze social media posts from Claude, ChatGPT, Cursor, or Gemini. SocialRobot's remote MCP server connects Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, and Mastodon, then creates,