Telegram MCP Server
@clean99
An MCP server implementation that provides tools for interacting with the [Telegram Bot API](
Overview
What is Telegram MCP Server?
Telegram MCP Server is an MCP server implementation that provides tools for interacting with the Telegram Bot API. It allows AI assistants to send messages, retrieve bot information, and manage updates programmatically.
How to use Telegram MCP Server?
Set the TELEGRAM_BOT_TOKEN environment variable with a bot token obtained from @BotFather on Telegram. For development, install dependencies with npm install, build with npm run build, and launch using the inspector: npx @modelcontextprotocol/inspector node dist/index.js.
Key features of Telegram MCP Server
- Retrieve basic bot information
- Send messages to specified chats
- Receive incoming updates via long polling
- Forward messages between chats
- Configure optional parameters for messages
Use cases of Telegram MCP Server
- AI assistant sending notifications or alerts to a chat
- Bot reading incoming updates and responding to users
- Forwarding important messages to other channels or groups
- Getting bot profile information for verification or logging
FAQ from Telegram MCP Server
How do I get a Telegram Bot token?
Talk to @BotFather on Telegram and use the /newbot command. You will receive a token after providing a name and username for your bot.
What runtime dependencies are required?
Node.js and npm are needed to run the server.
Can I change the bot username later?
No, the username cannot be changed once created, so choose it carefully.
What authentication is used?
The server authenticates with the Telegram Bot API using a token stored in the TELEGRAM_BOT_TOKEN environment variable.
