Claude MarketplacesSubmit
yybd avatar

telegram-notify

yybd/telegram-notify-mcp

Send-only Telegram notifications to one fixed chat. No polling, no recipient override, 2 tools.

tools
2
auth
Secret needed
transport
STDIO
env vars
3
last updated
Nov 7, 2026
View on GitHub

Tools

2 tools

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

notifySends `text` to your chat. Plain text by default; `format: "markdown"` turns `**bold**`, `_italic_`, `` `code` ``, code blocks, `[links](https://…)` and `# headings` into Telegram HTML, with everything else escaped. Over 4096 characters it is split into several messages. `sile...

Sends `text` to your chat. Plain text by default; `format: "markdown"` turns `**bold**`, `_italic_`, `` `code` ``, code blocks, `[links](https://…)` and `# headings` into Telegram HTML, with everything else escaped. Over 4096 characters it is split into several messages. `sile...

No parameter schema in public metadata yet.

notify_fileSends a file (up to 50 MB) with an optional caption, only from one folder you allow (`TELEGRAM_NOTIFY_FILES_DIR`). Paths are resolved to their real location first, so `..` and symlinks cannot reach outside it. Without that variable every call is refused

Sends a file (up to 50 MB) with an optional caption, only from one folder you allow (`TELEGRAM_NOTIFY_FILES_DIR`). Paths are resolved to their real location first, so `..` and symlinks cannot reach outside it. Without that variable every call is refused

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

Bot token from @BotFather (or run `telegram-notify-mcp setup` to save it to a file instead)

TELEGRAM_CHAT_ID*

The one chat that receives every message; tools cannot change it

TELEGRAM_NOTIFY_FILES_DIR

Folder notify_file may send from. Unset means file sending is off

Readme

English · עברית

telegram-notify MCP

telegram-notify MCP

A small, send-only MCP server that lets Claude (or any MCP client) send Telegram notifications to you: a scheduled job finished, a long build failed, a reminder came due.

  • One fixed recipient. The chat is set in configuration. No tool takes a chat id, so the model cannot send anywhere else.
  • Never polls. It calls sendMessage, sendDocument and getMe, and never getUpdates. The same bot can keep serving another tool that polls it (for example the Claude Code Telegram channel plugin) with no 409 Conflict, and nothing expires after 24 hours.
  • Two tools, no Telegram library, two runtime dependencies (the MCP SDK and zod).

The story behind it, with the comparison against eight other Telegram MCP servers: Let Claude message you on Telegram, and only you.

Tools

View the full README on GitHub

Details

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

More from yybd

Related Communication & Messaging MCP servers

View all
1codefuturist avatarEmail Mcpcodefuturist/email-mcpIMAP/SMTP email MCP server — 52 tools, stdio + HTTP, IMAP IDLE push, multi-account, AI triage.147stars
2n24q02m avatarEmailn24q02m/emailIMAP/SMTP email for AI agents -- read, send, organize, and manage attachments across accounts.37stars
3n24q02m avatarTelegram MCPn24q02m/telegramTelegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.11stars
4virtualsms-io avatarSmsvirtualsms-io/mcp-serverReal SIM numbers for AI agents: SMS verification, rentals, proxies, cloud browser, x402 deposits.0stars
5initechsoftware avatarWhatsApp MCP by TimelinesAIinitechsoftware/whatsapp-mcp-by-timelinesaiAsk questions across your WhatsApp inbox from Claude, ChatGPT, Cursor or any MCP client.5stars
6boutquin avatarEmail (IMAP/SMTP)boutquin/mcp-server-emailMulti-account IMAP/SMTP email server with 22 tools for reading, sending, searching, and organizing.2stars