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
Tools
2 toolsPublic 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 monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent 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 languageConfiguration
TELEGRAM_BOT_TOKEN*secretBot 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_DIRFolder 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,sendDocumentandgetMe, and nevergetUpdates. The same bot can keep serving another tool that polls it (for example the Claude Code Telegram channel plugin) with no409 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
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
