Claude MarketplacesSubmit
parthjadhav avatar

Telegram Notify Mcp

parthjadhav/telegram-notify-mcp

Connects Claude to the Telegram Bot API to push notifications while your agent works. Exposes three tools: send_message for text updates, send_photo for images or charts, and send_document for files. You configure it with a bot token from BotFather and your Telegram username, then walk away while long-running tasks send you progress updates or completion alerts. The server resolves your username to a chat ID on first use and caches it. Deliberately scoped to outbound notifications only, no chat management or inline queries. Useful when you kick off data processing, report generation, or any agent task where you want async status updates on your phone instead of watching terminal output.

GitHub stars
7
tools
3
auth
Secret needed
transport
STDIO
env var
1
last updated
Feb 22, 2026
View on GitHub

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

send_messageSend a text update to the user.

Send a text update to the user.

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

TELEGRAM_BOT_TOKEN*secret

Telegram Bot API token from BotFather

Readme

bloom-banner-01-light-tags-1500x500

Telegram Notify MCP

npm version License: MIT

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

  1. Message @BotFather on Telegram
  2. Send /newbot and follow the prompts
  3. 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

View the full README on GitHub

Details

Repository
github.com/parthjadhav/telegram-notify-mcp
Category
Communication & Messaging
Package
@parthj/telegram-notify-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1samihalawa avatarSamihalawa Whatsapp Go Mcpsamihalawa/whatsapp-go-mcpScan QR codes and go! No more troublesome autos or APIs! Send text messages, images, links, locati…5stars
2adelaidasofia avatarMulti-workspace Slack MCP server with draft+confirm safety, vault auto-export, aadelaidasofia/slack-mcpMulti-workspace Slack MCP server with draft+confirm safety, vault auto-export, and triple-mode…1stars
3pipeworx-io avatarOutlook Calendarpipeworx-io/mcp-outlook-calendarOutlook Calendar MCP Pack1stars
4nakulben avatarWhatsApp MCP Servernakulben/whatsapp-mcpManage WhatsApp Business templates and send messages via Meta Cloud API1stars
5surgeenterpriseai avatarMicrosoft Teamssurgeenterpriseai/teams-mcp-serverConnect Claude to Microsoft Teams — read/send messages, list channels, search chats.1stars
6csoai-org avatarNotification Ai Mcpcsoai-org/notification-ai-mcpNotification Ai MCP Server by MEOK AI Labs0stars