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