🧠 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
- License
- MIT
Explore
- 🔄 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
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
npx telegram-bot-mcp-server
npm install -g telegram-bot-mcp-server
npm install telegram-bot-mcp-server
1. Node.js 18+: Download here
2. Telegram Bot Token: Get one from @BotFather
1. Open Telegram and search for @BotFather
2. Start a conversation and run: /newbot
3. Follow the prompts to name your bot
4. Copy the API token provided
Add this configuration to your MCP client (Claude Desktop, etc.):
{
"mcpServers": {
"telegram_bot": {
"command": "npx",
"args": ["telegram-bot-mcp-server"],
"env": {
"TELEGRAM_BOT_API_TOKEN": "your_bot_token_here"
}
}
}
}
Using global installation:
{
"mcpServers": {
"telegram_bot": {
"command": "telegram-bot-mcp-server",
"env": {
"TELEGRAM_BOT_API_TOKEN": "your_bot_token_here"
}
}
}
}
Using local installation:
{
"mcpServers": {
"telegram_bot": {
"command": "node",
"args": ["./node_modules/.bin/telegram-bot-mcp-server"],
"env": {
"TELEGRAM_BOT_API_TOKEN": "your_bot_token_here"
}
}
}
}
```
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"
]
}
}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.
