Telegram Notification MCP Server
@kstonekuan
About Telegram Notification MCP Server
Simple MCP server to send you notifications on telegram
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.
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.
Basic information
More Communication MCP servers
Slack
modelcontextprotocolModel Context Protocol Servers
feishu-tools-mcp
Li-vienMCP server provides Feishu related operations to AI encoding agents such as cursor 飞书MCP插件，读取文档、发送消息、合同审批、数据处理.....
WhatsApp Web MCP
pnizerWhatsApp Web MCP Server
mcp-email-server
ai-zerolabIMAP and SMTP via MCP Server
Mcp Telegram
dryeabMCP Server for Telegram
Comments