Send notifications from AI agents directly to your Telegram account via a bot.
Send text messages (send_message): Plain or formatted text using HTML, Markdown, or MarkdownV2
Send photos (send_photo): Images via URL or local file path, with an optional formatted caption
Send documents/files (send_document): Files (reports, logs, artifacts) via URL or local file path, with an optional formatted caption
Configure once with a bot token and username, then receive automatic notifications from MCP clients like Claude Desktop, Cursor, and Windsurf.
Provides tools to send text messages, images, and files as notifications to users through a Telegram bot.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Telegram Notify MCP Send a notification to my Telegram once the report is ready"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A dead-simple MCP server with one job: send AI agent progress back to you on Telegram.
That's it. No chat management, no group administration, no inline queries. Just notifications — as text, images, or files.
You kick off an agent, walk away, and get a Telegram message when it's done (or while it's working). Nothing more, nothing less.
Message @BotFather on Telegram
Send /newbot and follow the prompts
Copy the bot token
Find your bot on Telegram and send /start. This is required so the bot can discover your chat ID.
claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcpAdd to your MCP config file:
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": ["-y", "@parthj/telegram-notify-mcp"],
"env": {
"TELEGRAM_BOT_TOKEN": "your-bot-token",
"TELEGRAM_USERNAME": "your-telegram-username"
}
}
}
}Related MCP server: telegram-commandcode
Environment Variable | Required | Description |
| Yes | Bot token from @BotFather |
| Yes | Your Telegram username (without the @) |
Three tools. That's the entire surface area.
send_messageSend a text update to the user.
Parameter | Type | Required | Description |
| string | Yes | The message text |
| string | No |
|
send_photoSend an image — a screenshot, a chart, a generated visual.
Parameter | Type | Required | Description |
| string | Yes | URL or absolute file path |
| string | No | Photo caption |
| string | No | Caption formatting mode |
send_documentSend a file — a report, a log, a build artifact.
Parameter | Type | Required | Description |
| string | Yes | URL or absolute file path |
| string | No | Document caption |
| string | No | Caption formatting mode |
On the first tool call, the server resolves your username to a chat ID via the Telegram Bot API's getUpdates
Sending /start to the bot is required — Telegram bots can only message users who have initiated a conversation
The chat ID is cached for the lifetime of the process
git clone https://github.com/ParthJadhav/telegram-notify-mcp.git
cd telegram-notify-mcp
npm install
npm run buildMIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP server for AI dialogue using various LLM models via AceDataCloud
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ParthJadhav/telegram-notify-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server