telegram-notification-mcp

kstonekuan/telegram-notification-mcp

3.4

If you are the rightful owner of telegram-notification-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Telegram Notification MCP Server is a server that sends notifications to Telegram when Claude Code completes tasks, built with TypeScript using the Cloudflare Agents SDK.

The Telegram Notification MCP Server is designed to facilitate seamless communication between Claude Code and Telegram by sending notifications upon task completion. This server is built using TypeScript and leverages the Cloudflare Agents SDK, making it deployable on Cloudflare Workers. It supports both Server-Sent Events (SSE) and Streamable HTTP transport methods, ensuring compatibility and reliability. The server is secure, utilizing Cloudflare secrets for credential management, and supports message formatting in Markdown and HTML. Durable Objects are employed for state management, which is essential for maintaining stateful connections required by McpAgent. The server is designed to be globally distributed and serverless, providing efficient and scalable notification services.

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.
  • Message Formatting: Supports Markdown and HTML formatting.

Usages

usage with Claude Code SSE

bash
claude mcp add telegram-notify https://your-worker-name.workers.dev/sse -t sse

usage with Claude Code local

bash
claude mcp add telegram-notify http://localhost:8787/sse -t sse

Tools

  1. send_telegram_message

    Send a notification message to Telegram.