Telegram Notify Mcp
Send real-time notifications from AI agents and backend services to Telegram for alerts, updates, and user notifications.
Overview
io.github.ParthJadhav/telegram-notify-mcp is a Build-phase MCP server that sends Telegram text, photo, and document notifications from AI agents via a stdio npm package and BotFather token.
What is this MCP server?
- Send text, photos, and documents via Telegram
- MCP-native integration for AI agents
- Real-time notifications for alerts and updates
- Package version 1.0.1 (@parthj/telegram-notify-mcp)
- Transport: stdio
- 1 required secret environment variable: TELEGRAM_BOT_TOKEN
Community signal: 7 GitHub stars.
What problem does it solve?
Builders stare at long agent runs with no mobile-friendly alert when a deploy, scrape, or batch job succeeds or breaks.
Who is it for?
Solo developers who already use Telegram and want the simplest MCP path to outbound alerts from Claude Code or Cursor.
Skip if: Products that need Slack-first incident management, inbound Telegram command bots, or compliance-grade messaging archives.
What do I get? / Deliverables
After configuring the bot token and MCP entry, your agent can push Telegram messages and attachments so you get notified without polling the terminal.
- MCP tools to send Telegram text, photos, and documents from agent workflows
- Phone-visible alerts without custom bot code in each repository
Recommended MCP Servers
Journey fit
This tool belongs in the build phase because it's a ready-to-integrate communication layer for adding notification functionality to an agent or application. Integrations is the right subphase since this MCP acts as a bridge between an AI agent and Telegram's messaging service.
How it compares
Outbound Telegram Bot MCP bridge, not a full communication platform skill or a marketing distribution playbook.
Common Questions / FAQ
Who is io.github.ParthJadhav/telegram-notify-mcp for?
It is for solo builders and agent users who want Telegram as a notification channel for coding agents and automation, using a standard BotFather token.
When should I use io.github.ParthJadhav/telegram-notify-mcp?
Use it while building or shipping when you wire agents or scripts to notify you on completion, failures, or human-in-the-loop prompts on your phone.
How do I add io.github.ParthJadhav/telegram-notify-mcp to my agent?
Install @parthj/telegram-notify-mcp from npm, set TELEGRAM_BOT_TOKEN in your MCP server environment, register the stdio server in your client config, and restart the agent.