🧠 Telegram Bot MCP Server
About
Telegram Bot MCP Server is a Model Context Protocol (MCP) server that integrates the Telegram Bot API into AI assistants. It provides tools for sending messages, managing users, and configuring bot settings, with intelligent message splitting and comprehensive error handling. It…
Details
- Author
- siavashdelkhosh81
- GitHub stars
- 7
- Downloads
- 1,259
- Categories
- Communication
Jump to
- Intelligent message splitting for Telegram’s 4096-character limit
- Comprehensive error handling with detailed error codes
- NPX support for zero-install execution
- Easy integration with MCP clients
- Rich API coverage for messaging, user management, and bot configuration
- Cross-platform support (Windows, macOS, Linux)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🧠 Telegram Bot MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run directly with npx telegram-bot-mcp-server after setting the TELEGRAM_BOT_API_TOKEN environment variable with a bot token from BotFather. Alternatively, install globally or locally via npm and configure your MCP client (e.g., Claude Desktop) with the server command and environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83e\udde0 telegram bot mcp server": {
"telegram-bot-mcp-server": {
"command": "npx",
"args": [
"telegram-bot-mcp-server"
]
}
}
}
}McpServers
{
"telegram-bot-mcp-server": {
"command": "npx",
"args": [
"telegram-bot-mcp-server"
]
}
}🧠 Telegram Bot MCP Server
A powerful Model Context Protocol (MCP) server for seamless Telegram Bot API integration with intelligent message splitting, comprehensive error handling, and NPX support.
✨ Key Features
- 🔄 Intelligent Message Splitting: Automatically handles Telegram's 4096 character limit while preserving word boundaries and formatting
- 🛡️ Comprehensive Error Handling: Detailed error reporting with context, error codes, and debugging information
- 📦 NPX Support: Run directly with npx telegram-bot-mcp-server - no installation required
- 🔧 Easy Integration: Simple MCP client configuration for AI assistants
- 📝 Rich API Coverage: Complete Telegram Bot API functionality including messaging, user management, and bot configuration
🚀 Quick Start
Option 1: NPX (Recommended)
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
