Send Telegram notifications from AI agents — text, photos, and documents.
MCPpedia last refreshed this data
io.github.ParthJadhav/telegram-notify-mcp is an MCP server that send Telegram notifications from AI agents — text, photos, and documents. Its tool list has not been published yet over stdio and sse, requires no API key, and scores 79/100 on MCPpedia's security, maintenance and efficiency rubric.
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.
Send Telegram notifications from AI agents — text, photos, and documents.
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.
Click any tool to inspect its schema.
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
Official TypeScript library for the Telnyx API
Send email and newsletters with Mailtea over MCP, plus skills for email and website design.
CVSS scoring, IOC extraction, email header triage, hash/JWT/timestamp decoding, CISA KEV lookup.
Open-source SMS gateway. Turn your Android phone into an SMS API: send and receive SMS from your apps over REST and webhooks. Self-hostable, with a free hosted plan.
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