Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"telegram": {
"env": {
"TELEGRAM_USERNAME": "your-telegram-username",
"TELEGRAM_BOT_TOKEN": "your-bot-token"
},
"args": [
"-y",
"@parthj/telegram-notify-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
A dead-simple MCP server with one job: send AI agent progress back to you on Telegram.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@parthj/telegram-notify-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @parthj/telegram-notify-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in communication
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
PubNub Model Context Protocol MCP Server for Cursor and Claude
Social layer for Claude Code - DMs, presence, discovery, and games between AI-assisted developers
MCP server for Voximplant API — call history, users, SMS. 3 tools.
MCP Security Weekly
Get CVE alerts and security updates for io.github.ParthJadhav/telegram-notify-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
/newbot and follow the promptsFind 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-mcp
Add 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"
}
}
}
}
| Environment Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN | Yes | Bot token from @BotFather |
TELEGRAM_USERNAME | 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 |
|---|---|---|---|
text | string | Yes | The message text |
parse_mode | string | No | HTML, Markdown, or MarkdownV2 |
send_photoSend an image — a screenshot, a chart, a generated visual.
| Parameter | Type | Required | Description |
|---|---|---|---|
photo | string | Yes | URL or absolute file path |
caption | string | No | Photo caption |
parse_mode | string | No | Caption formatting mode |
send_documentSend a file — a report, a log, a build artifact.
| Parameter | Type | Required | Description |
|---|---|---|---|
document | string | Yes | URL or absolute file path |
caption | string | No | Document caption |
parse_mode | string | No | Caption formatting mode |
getUpdates/start to the bot is required — Telegram bots can only message users who have initiated a conversationgit clone https://github.com/ParthJadhav/telegram-notify-mcp.git
cd telegram-notify-mcp
npm install
npm run build
MIT