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

Faxify MCP

Const Agility, LLC

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

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

SocialFaktory

Run a brand's social media from your agent: write posts in the brand's voice, generate short videos, schedule and publish to TikTok, Instagram, YouTube, X, LinkedIn, Facebook and Pinterest, and read the metrics back. 21

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.