Telegram Notification MCP Server
About
Simple MCP server to send you notifications on telegram
Details
- License
- MIT
Explore
- 🤖 MCP Tool: Provides a send_telegram_message tool for sending notifications
- 🚀 Cloudflare Workers: Runs serverless with global distribution
- 🔐 Secure: Uses Cloudflare secrets for credentials
- 🌐 Dual Transport: Supports both SSE and Streamable HTTP for maximum compatibility
- 💾 Durable Objects: State management required by McpAgent
- 💬 Message Formatting: Supports Markdown and HTML formatting
- 📝 Formatting: Supports Markdown and HTML message formatting
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Telegram Notification MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Telegram Bot: Create a bot via @BotFather and get your bot token
2. Chat ID: Get your chat ID by sending a message to your bot and visiting:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
3. Cloudflare Account: Sign up at cloudflare.com
Deploy to Cloudflare Workers:
Deploy using Wrangler:
pnpm run deploy
Alternative: Continuous Deployment
You can also set up continuous deployment directly from the cloudflare dashboard. Learn more about git integration with cloudflare
Add the MCP server to Claude Code using the CLI via SSE transport:
```bash
claude mcp add telegram-notify https://your-worker-name.workers.dev/sse -t sse
text
(required): The message text to send
chat_id
(optional): Telegram chat ID (uses DEFAULT_CHAT_ID if not provided)
parse_mode
(optional): "Markdown" or "HTML" for message formatting
disable_notification
(optional): Send message silently
send_telegram_message: Send a notification message to Telegram
- text (required): The message text to send
- chat_id (optional): Telegram chat ID (uses DEFAULT_CHAT_ID if not provided)
- parse_mode (optional): "Markdown" or "HTML" for message formatting
- disable_notification (optional): Send message silently
Example usage:
// Uses DEFAULT_CHAT_ID from environment
await send_telegram_message({ text: "Task completed!" })
// Send to specific chat (overrides DEFAULT_CHAT_ID)
await send_telegram_message({ text: "Hello!", chat_id: "123456789" })
// Send with Markdown formatting
await send_telegram_message({
text: "Bold and _italic_ text",
parse_mode: "Markdown"
})
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"telegram notification mcp server": {
"telegram-notification-mcp": {
"command": "npx",
"args": [
"wrangler",
"secret",
"put",
"BOT_TOKEN"
]
}
}
}
}McpServers
{
"telegram-notification-mcp": {
"command": "npx",
"args": [
"wrangler",
"secret",
"put",
"BOT_TOKEN"
]
}
}<div align="center">
An MCP (Model Context Protocol) server that sends notifications to Telegram when Claude Code completes tasks. Built with TypeScript using the Cloudflare Agents SDK and deployable on Cloudflare Workers.
</div>
> 📢 Prefer Discord? Check out Discord Notification MCP for Discord notifications instead.
Features
- 🤖 MCP Tool: Provides a send_telegram_message tool for sending notifications
- 🚀 Cloudflare Workers: Runs serverless with global distribution
- 🔐 Secure: Uses Cloudflare secrets for credentials
- 🌐 Dual Transport: Supports both SSE and Streamable HTTP for maximum compatibility
- 💾 Durable Objects: State management required by McpAgent
- 💬 Message Formatting: Supports Markdown and HTML formatting
- 📝 Formatting: Supports Markdown and HTML message formatting
Architecture
This server implements the MCP specification using Cloudflare's Agents SDK:
- GET /sse: SSE endpoint for MCP communication
- POST /mcp: Streamable HTTP endpoint for MCP communication
- Built with TypeScript, MCP SDK, and Cloudflare Agents SDK
- Proper JSON-RPC 2.0 error handling
- Durable Objects for stateful connections (required by McpAgent)
- Node.js compatibility mode enabled
Setup
Prerequisites
1. Telegram Bot: Create a bot via @BotFather and get your bot token
2. Chat ID: Get your chat ID by sending a message to your bot and visiting:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
3. Cloudflare Account: Sign up at cloudflare.com
Installation
1. Clone this repository
2. Install dependencies:
pnpm install
Configuration
1. Create a .dev.vars file from the example:
cp .dev.vars.example .dev.vars
Then edit
.dev.vars with your bot token and chat ID. This file is used for both local development and deployment.
2. For production deployment, set up Cloudflare secrets:
npx wrangler secret put BOT_TOKEN
npx wrangler secret put DEFAULT_CHAT_ID # Optional
Note: The DEFAULT_CHAT_ID is optional. If not set, you must provide a chat_id parameter when calling the
send_telegram_message tool.
3. Update wrangler.toml with your worker name if desired
Deployment
Deploy to Cloudflare Workers:
Deploy using Wrangler:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
