A Model Context Protocol (MCP) server that enables AI agents to send messages, photos, documents, and videos via Telegram bot
A Model Context Protocol (MCP) server that enables AI agents to send messages via Telegram bot. Perfect for notifications, alerts, and real-time communication from your AI applications.
Features
📱 Send messages to Telegram channels/chats via bot
🎨 Support for multiple formatting modes (Markdown, MarkdownV2, HTML)
📷 Send photos/images (local files, HTTP URLs)
📁 Send documents/files with custom filenames
🎬 Send videos with caption support
🏷️ Caption support for all media with full formatting
🛡️ Robust error handling with detailed Telegram API responses
🏗️ Clean service architecture for maintainable code
Visit the same URL and find the chat.id (negative number for channels)
3. Install and Configure
# Install the package
npm install -g @harnyk/telegram-notifier-mcp
# Or clone and build locally
git clone <repository-url>
cd mcp-telegram-notifier
pnpm install
pnpm build
pnpm link
4. Add to Your MCP Client
Add to your MCP client configuration (e.g., Claude Desktop):
Once configured, your AI agent will have access to these MCP tools:
📝 send_markdown_message_as_telegram_bot
Send formatted text messages to Telegram
messageText: Text content with Markdown/HTML formatting
parseMode: Markdown, MarkdownV2, or HTML (default: MarkdownV2)
📷 send_telegram_photo
Send photos/images to Telegram
photo: Local file path or HTTP URL to image
caption: Optional image caption with formatting
parseMode: Caption formatting mode
📁 send_telegram_document
Send documents/files to Telegram
document: Local file path or HTTP URL to document
caption: Optional document caption with formatting
filename: Custom filename override
parseMode: Caption formatting mode
🎬 send_telegram_video
Send videos to Telegram
video: Local file path or HTTP URL to video
caption: Optional video caption with formatting
filename: Custom filename override
parseMode: Caption formatting mode
Use Cases
📊 Monitoring: Get alerts when system metrics exceed thresholds
🚀 Deployments: Notifications when CI/CD pipelines complete
📈 Analytics: Daily/weekly reports with charts and data files
🔍 Error Tracking: Instant notifications with error screenshots
📅 Scheduling: Reminders with attached documents
💬 Customer Support: Forward important messages with media
Development
# Install dependencies
pnpm install
# Run in development mode
pnpm dev
# Build for production
pnpm build
# Run linting
pnpm lint
# Run type checking
pnpm typecheck
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
MCP Telegram Notifier ต้องใช้ API key ไหม?
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
MCP Telegram Notifier ใช้ทรานสปอร์ตแบบใด?
MCP Telegram Notifier ทำงานแบบโลคัลผ่าน stdio
MCP Telegram Notifier ถูกตรวจสอบล่าสุดเมื่อใด?
ตรวจสอบล่าสุดเมื่อ 2026-10-27 A Model Context Protocol (MCP) server that enables AI agents to send messages, photos, documents, and videos via Telegram bot