Telegram Notify MCP server

by ParthJadhav·io.github.ParthJadhav/telegram-notify-mcp·v1.0.1·7 stars

No reviews yet

Send Telegram notifications from AI agents — text, photos, and documents.

C66/100grade C

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

C66/100

full report

Adoption

New

7 stars54 downloads/wk

Reviews

Write one

Nobody has reviewed Telegram Notify yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Telegram Notify tools (3, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

send_documentwrite action
Send a document or file to the configured Telegram user. Accepts a URL or local file path.
send_messagewrite action
Send a text message to the configured Telegram user
send_photowrite action
Send a photo to the configured Telegram user. Accepts a URL or local file path.

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings

Code scan3 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 199 days ago4/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 66/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Telegram Notify compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 66/100; higher than 23% of 48,273 servers
Tools: 3; the typical server has 7
Tools that change things: 100%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 7; more than 86% of 28,534 servers
Downloads a week: 54; more than 46% of 11,915 servers with a package

What its tools let an agent do: 3 send or post

Install Telegram Notify in Claude Code, Cursor or VS Code

Runs npx -y @parthj/telegram-notify-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add telegram-notify-mcp -- npx -y @parthj/telegram-notify-mcp

Add to Cursor

What the publisher says

From the Telegram Notify repository's README, as published. We do not edit it. Read it on GitHub

Telegram Notify MCP

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.

Quick Start

1. Create a Telegram Bot

Message @BotFather on Telegram
Send /newbot and follow the prompts
Copy the bot token

2. Start a chat with your bot

Find your bot on Telegram and send /start. This is required so the bot can discover your chat ID.

3. Add to your MCP client

Claude Code

claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp

Claude Desktop / Cursor / Windsurf

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"
      }
    }
  }
}

Configuration

Tools

Three tools. That's the entire surface area.

send_message

Send a text update to the user.

send_photo

Send an image — a screenshot, a chart, a generated visual.

send_document

Send a file — a report, a log, a build artifact.

How It Works

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

Development

git clone https://github.com/ParthJadhav/telegram-notify-mcp.git
cd telegram-notify-mcp
npm install
npm run build

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Telegram Notify: common questions

Is Telegram Notify MCP server safe?: With care: it is graded C, so read the findings first (66/100). Read the Telegram Notify safety report
How do I install Telegram Notify?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Telegram Notify need an API key?: Yes. The registry entry asks for TELEGRAM_BOT_TOKEN.
Is Telegram Notify maintained?: The last commit was 234 days ago (2026-03-13). The latest release is v1.0.1.
How does Telegram Notify compare with other MCP servers?: safety score 66/100 (higher than 23% of 48,273 servers); tools 3 (the typical server has 7); tools that change things 100% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.