Send Telegram notifications from AI agents — text, photos, and documents.
Send Telegram notifications from AI agents — text, photos, and documents.
Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: TELEGRAM_BOT_TOKEN
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-parthjadhav-telegram-notify-mcp": {
"env": {
"TELEGRAM_BOT_TOKEN": "your-telegram-bot-token-here"
},
"args": [
"-y",
"@parthj/telegram-notify-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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
Be the first to review this server!
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption