Overview
Send and receive Telegram messages via bot API for community management.
Setup
Run with npx:
npx -y @modelcontextprotocol/server-telegramConfiguration
TELEGRAM_BOT_TOKEN environment variableDocumentation
Telegram MCP (Enhanced)
Overview
Telegram MCP provides access to Telegram Bot API for sending and receiving messages.
Features
- Send messages
- Receive messages
- Group management
- File sharing
- Inline keyboards
Installation
npx -y @modelcontextprotocol/server-telegram
Configuration
Set up Telegram bot token:
export TELEGRAM_BOT_TOKEN=your_bot_token
Create your bot at BotFather.
Available Operations
| Operation | Description |
|---|---|
| Send Message | Send text to chat |
| Get Updates | Poll for new messages |
| Forward Message | Forward existing message |
| Send Photo | Send image file |
| Send Document | Send any file |
Usage Examples
Send Message
{
"action": "send_message",
"chat_id": "123456789",
"text": "Hello from AI agent!"
}
Get Updates
{
"action": "get_updates",
"timeout": 30,
"offset": 0
}
Send Photo
{
"action": "send_photo",
"chat_id": "123456789",
"photo": "path/to/image.jpg",
"caption": "Here's the report"
}
Pros
- ✅ Fast and reliable messaging
- ✅ Rich media support
- ✅ Group and channel support
- ✅ Easy bot setup
Cons
- ❌ Requires bot token
- ❌ Limited to Telegram ecosystem
- ❌ Message history limits
