MCP Telegram Bot
MCP server that lets AI clients send messages and read updates via a Telegram bot
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About MCP Telegram Bot
MCP Telegram Bot is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
The README says the server wraps a Telegram bot so that MCP-compatible AI clients can call it as a set of tools. Setup starts with creating a bot through BotFather on Telegram, then supplying the bot token through the TELEGRAM_BOT_TOKEN environment variable before launching the server over stdio.
Once running, it exposes three tools: sending a message to a chat, returning the bot's own identity, and fetching recent updates received by the bot. It also offers a bot status resource. The project is published on PyPI and is MIT licensed.
It suits developers who want an assistant or agent to post into Telegram chats or check incoming bot traffic without writing their own integration.
Install
Run in a terminal
claude mcp add mcp-telegram-bot -- uvx mcp-telegram-botAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-telegram-bot": {
"command": "uvx",
"args": [
"mcp-telegram-bot"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-telegram-bot": {
"command": "uvx",
"args": [
"mcp-telegram-bot"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-telegram-bot": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-telegram-bot"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-telegram-bot": {
"command": "uvx",
"args": [
"mcp-telegram-bot"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-telegram-bot": {
"command": "uvx",
"args": [
"mcp-telegram-bot"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- send_message
- Send a message to a Telegram chat
- get_me
- Get bot information
- get_updates
- Get recent updates from Telegram
What it does
- Send chat messages
- Lets an AI client post a message into a Telegram chat through the bot.
- Bot identity lookup
- Returns information about the bot account using the get_me tool.
- Recent update retrieval
- Fetches recent updates the bot has received from Telegram.
- Bot status resource
- Exposes a bot://status MCP resource describing the bot's state.
- Stdio transport
- Runs as a local process over stdio and installs from PyPI with pip.
Good for
- Let an AI assistant send notifications to a Telegram chat
- Check which messages a Telegram bot has recently received
- Confirm the bot's account details during agent setup
Pricing
Open source
Free and open source under MIT.
More servers for the same service
MCP Telegram Bot FAQ
How is the server configured?
Set the TELEGRAM_BOT_TOKEN environment variable to a token obtained from @BotFather, then run mcp-telegram-bot.
What license is it under?
The README lists the MIT license.
Is MCP Telegram Bot free?
Yes. MCP Telegram Bot is open source, so you can use and self-host it for free.
How do I add MCP Telegram Bot to Claude Code?
Run this command in your terminal: claude mcp add mcp-telegram-bot -- uvx mcp-telegram-bot
What are the best alternatives to MCP Telegram Bot?
The closest alternatives to MCP Telegram Bot are Telegram MCP by usefulapi, Telegram MCP, MCP Zmq, Fast MCP Telegram and Telegram (tg-mcp).
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.