Telegram Notifier (Botfather)
About
Use botfather bot to notify yourself on Telegram.
Details
- Author
- adeshatole
- Categories
- Communication, Other
Jump to
Setup
Install Telegram Notifier (Botfather) in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/adeshatole/telegram-notifier-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Use botfather bot to notify yourself on Telegram.
No cloning or building required — just add the config to your MCP client.
- Open Telegram and message@BotFather
- Send/newbotand follow the prompts to name your bot
- Copy thebot tokenyou receive (e.g.,123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
- Send any message to your new bot on Telegram
- Open the following URL in your browser, replacingYOUR_BOT_TOKENwith your actual token:
https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
Tip:For group chats, add the bot to the group, send a message, and check the same URL. Group chat IDs are negative numbers (e.g.,-1001234567890).
Add this to your Claude Desktop config file:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "telegram-notifier": { "command": "npx", "args": ["telegram-notifier-mcp"], "env": { "TELEGRAM_BOT_TOKEN": "your-bot-token-here", "TELEGRAM_CHAT_ID": "your-chat-id-here" } } } }
Add to your project's.mcp.jsonor~/.claude.json:
{ "mcpServers": { "telegram-notifier": { "command": "npx", "args": ["telegram-notifier-mcp"], "env": { "TELEGRAM_BOT_TOKEN": "your-bot-token-here", "TELEGRAM_CHAT_ID": "your-chat-id-here" } } } }
You can configure Codex CLI in either of these ways:
Option A: Add it manually in~/.codex/config.toml
[mcp_servers.telegram-notifier] command = "npx" args = ["telegram-notifier-mcp"] [mcp_servers.telegram-notifier.env] TELEGRAM_BOT_TOKEN = "your-bot-token-here" TELEGRAM_CHAT_ID = "your-chat-id-here"
codex mcp add telegram-notifier \ --env TELEGRAM_BOT_TOKEN=your-bot-token-here \ --env TELEGRAM_CHAT_ID=your-chat-id-here \ -- npx telegram-notifier-mcp
That's it — your LLM can now send you Telegram notifications.
The server uses two environment variables:
The server will exit with an error ifTELEGRAM_BOT_TOKENis not set. IfTELEGRAM_CHAT_IDis not set, you must passchatIdto every tool call.
Send a file/document to a Telegram chat.
Check for new messages sent to the bot. Only returns messages received since the last check.
When a message contains media (photo, document, video, audio, voice message, or sticker), the server automatically downloads the file to~/.telegram-notifier-mcp/downloads/and includes the local path in the output. This lets the LLM read or process the file directly.
- Files are saved as<timestamp>-<original_filename>to avoid collisions
- Photos are downloaded at the highest available resolution
- Telegram Bot API limits downloads to20 MB
- If a download fails, the output falls back to just labeling the media type
You can test the server interactively using theMCP Inspector:
TELEGRAM_BOT_TOKEN="your-token" TELEGRAM_CHAT_ID="your-chat-id" \ npx @modelcontextprotocol/inspector npx telegram-notifier-mcp
This opens a browser UI where you can invoke each tool and see the results.
The server handles errors gracefully and returns descriptive messages:
All server logs go tostderrso they never interfere with the stdio MCP transport on stdout.
Telegram enforces a50 MBlimit for file uploads via the Bot API. The server validates file size before uploading and returns an error if the limit is exceeded.
git clone https://github.com/AdeshAtole/telegram-notifier-mcp cd telegram-notifier-mcp npm install npm run build # Watch mode — rebuilds on file changes npm run dev
Releases are published to npm automatically via GitHub Actions when you create a GitHub release.
- Add your npm token as a repository secret namedNPM_TOKENin GitHub Settings > Secrets and variables > Actions
- Bump the version inpackage.json
- Create a new GitHub release — the workflow will build and publish to npm
Unified notification MCP server with 36 tools to send messages across 23 channels — Email, SMS, Slack, Telegram, Discord, Teams, WhatsApp, Firebase Push, and more.
A server for sending multi-platform notifications and creating interactive AI workflows, with support for Telegram, webhooks, and synchronous user interactions.
Send Telegram notifications from AI agents - text, photos, and documents via Bot API
Send Push Notifications and Live Activities to your paired iOS devices.
Send and receive emails, SMS, and voice calls via Pingram.
Platfone - Receive SMS & Virtual Numbers MCP
Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle
MCP server for Telegram bots built with aiogram. 30 tools, 7 resources, 3 prompts — messaging, rich media, moderation, interactive keyboards, real-time event streaming, rate limiting, permissions, and audit logging.
Send native macOS notifications and interact with system dialogs.
Send iOS push notifications using the Bark app.
Production-grade MCP server for Telegram with dual-mode Bot API + MTProto, 6 composite tools
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
