🧠 Telegram Bot MCP Server
@siavashdelkhosh81
About 🧠 Telegram Bot MCP Server
Telegram bot mcp server
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"telegram-bot-mcp-server": {
"command": "npx",
"args": [
"telegram-bot-mcp-server"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is Telegram Bot MCP Server?
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 is designed for developers and AI assistant users who need to interact with Telegram through MCP.
How to use Telegram Bot MCP Server?
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.
Key features of Telegram Bot MCP Server
- 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)
Use cases of Telegram Bot MCP Server
- Send long messages or photo captions that automatically split across messages
- Manage chat members by banning or unbanning users
- Retrieve chat and member information for monitoring
- Update bot name, description, and command list remotely
- Test bot authentication and retrieve bot details
FAQ from Telegram Bot MCP Server
What are the prerequisites for using this server?
Node.js 18+ and a Telegram Bot Token obtained from @BotFather.
How do I get a Telegram bot token?
Open Telegram, start a chat with @BotFather, send /newbot, follow the prompts to name your bot, and copy the provided API token.
What happens if my message exceeds 4096 characters?
The server automatically splits the message into parts while preserving word boundaries and formatting, and sends them sequentially with part indicators.
What should I do if I get a “No bot token” error?
Set the TELEGRAM_BOT_API_TOKEN environment variable to your bot token before running the server, e.g., export TELEGRAM_BOT_API_TOKEN="your_token_here".
How can I enable debug logging?
Set the environment variable NODE_ENV=development when running the server: NODE_ENV=development npx telegram-bot-mcp-server.
Frequently asked questions
What are the prerequisites for using this server?
Node.js 18+ and a Telegram Bot Token obtained from @BotFather.
How do I get a Telegram bot token?
Open Telegram, start a chat with @BotFather, send `/newbot`, follow the prompts to name your bot, and copy the provided API token.
What happens if my message exceeds 4096 characters?
The server automatically splits the message into parts while preserving word boundaries and formatting, and sends them sequentially with part indicators.
What should I do if I get a “No bot token” error?
Set the `TELEGRAM_BOT_API_TOKEN` environment variable to your bot token before running the server, e.g., `export TELEGRAM_BOT_API_TOKEN="your_token_here"`.
How can I enable debug logging?
Set the environment variable `NODE_ENV=development` when running the server: `NODE_ENV=development npx telegram-bot-mcp-server`.
Basic information
More Communication MCP servers
Slack MCP Server
korotovskyThe most powerful MCP Slack Server with no permission requirements, Apps support, GovSlack, DMs, Group DMs and smart history fetch logic.
Socialync
Jack VitickDraft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,
MCP Teams Server
InditexTechAn MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.
MCP Email Server
Shy2593666979一个基于 MCP (Model Context Protocol) 的邮件服务，支持 LLM 发送带附件的电子邮件及在指定目录中搜索文件。提供安全的 SMTP 传输、多收件人支持和附件模式匹配搜索功能，适用于 Gmail、Outlook、Yahoo、QQ 邮箱和网易 126 邮箱等主流邮箱服务。
Faxer
1771 CoSend real faxes to any US, Canadian, or international fax number from any AI assistant. The agent quotes the exact price from the document's real page count, hands the human a Stripe Checkout link (payment stays human-in
Comments