🔌

Telegram MCP

Communication700

Send and receive Telegram messages via bot API for community management.

Claude DesktopCursorWindsurf

Overview

Send and receive Telegram messages via bot API for community management.

Setup

Run with npx:

npx -y @modelcontextprotocol/server-telegram

Configuration

TELEGRAM_BOT_TOKEN environment variable

Documentation

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

OperationDescription
Send MessageSend text to chat
Get UpdatesPoll for new messages
Forward MessageForward existing message
Send PhotoSend image file
Send DocumentSend 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

Resources