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
An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.
Email & SMS infrastructure for AI agents — send and receive real email and text messages programmatically
A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API
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