telegram-notification-mcp

Telegram Notification MCP server sends alerts to Telegram when Claude Code tasks complete. Operations teams use it to monitor workflows. Connects to Cloudflare Agents SDK for integration.

[{"step":1,"action":"Install the telegram-notification-mcp server in your Claude Code environment. Run: `npm install -g @cloudflare/telegram-notification-mcp` or use the Cloudflare Workers CLI.","tip":"Ensure you have your Telegram Bot Token (from @BotFather) and Chat ID ready. Store these securely in environment variables (e.g., `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID`)."},{"step":2,"action":"Configure the MCP server in your Claude Code settings. Add the server to `claude.json` with the required parameters: bot token, chat ID, and optional message template.","tip":"Use the default template or customize it with placeholders like `[TASK_NAME]`, `[STATUS]`, or `[DURATION]` for dynamic alerts."},{"step":3,"action":"Trigger the notification by running a Claude Code task that includes the MCP server. For example, wrap your task in a function that calls `sendTelegramNotification()` after completion.","tip":"Test the setup with a simple task first (e.g., `echo \"Hello\"`). Verify the notification appears in your Telegram chat before deploying to production workflows."},{"step":4,"action":"Monitor the notifications in your Telegram chat. Use the alerts to track task statuses, errors, or completion times for your operations workflows.","tip":"For critical tasks, add error handling to send additional alerts if the task fails (e.g., include stack traces or logs in the message)."},{"step":5,"action":"Integrate with Cloudflare Agents SDK if needed. Use the SDK to automate the MCP server deployment or scale notifications across multiple tasks.","tip":"Refer to the Cloudflare Agents SDK documentation for advanced use cases, such as batching notifications or filtering alerts by priority."}]