io.github.daedalus/mcp-telegram-bot
Allows sending messages, retrieving bot information, and fetching recent updates from Telegram via a bot.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.daedalus/mcp-telegram-bot send 'Hello' to chat id 123456"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-telegram-bot
MCP server that exposes a Telegram bot
Install
pip install mcp-telegram-botRelated MCP server: telegram-mcp
Setup
Create a Telegram bot by talking to @BotFather on Telegram
Get your bot token
Set the
TELEGRAM_BOT_TOKENenvironment variable
Usage
export TELELEGRAM_BOT_TOKEN="your-bot-token-here"
mcp-telegram-botMCP Tools
send_message: Send a message to a Telegram chat
get_me: Get bot information
get_updates: Get recent updates from Telegram
MCP Resources
bot://status: Get bot status
mcp-name: io.github.daedalus/mcp-telegram-bot
Development
git clone https://github.com/daedalus/mcp-telegram-bot.git
cd mcp-telegram-bot
pip install -e ".[test]"
# run tests
pytest
# format
ruff format src/ tests/
# lint
ruff check src/ tests/
# type check
mypy src/License
MIT
Available Tools
3 toolsget_meA
Get bot information.
Returns: JSON response containing bot information (id, username, first_name, etc.).
Inputs: no named parameters. Returns: object
get_updatesB
Get recent updates from Telegram.
Inputs: limit, offset. Returns: result
send_messageB
Send a message to a specified Telegram chat.
Inputs: chat_id (required), text (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a distinct purpose: get_me retrieves bot info, get_updates fetches recent messages, and send_message sends messages. No overlap or ambiguity.
All tools use consistent snake_case and verb_noun pattern (get_me, get_updates, send_message), making them predictable.
With only 3 tools, the server is minimal but not unreasonable for a simple polling bot. However, for typical Telegram bot usage, more tools are expected.
The tool set covers basic functionality (get info, get updates, send messages) but misses essential operations like sending media, handling inline queries, or managing webhooks.
Maintenance
Related MCP Connectors
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
Related MCP Servers
- FlicenseBqualityDmaintenanceAn MCP server that enables interaction with Telegram messaging platform, allowing users to retrieve unread messages, fetch entity information, and send messages through natural language interfaces.610-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Telegram to send, read, and search messages across chats and dialogs. It supports waiting for incoming messages and retrieving conversation history through natural language commands.17 npm3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables Telegram bot interaction via Telegraf, providing tools for sending, replying, reacting, editing, deleting, forwarding messages, and receiving Telegram events over an optional notification channel.41 npm4MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server for sending and receiving Telegram messages via a bot, enabling AI assistants to interact directly through Telegram by sending messages, reading recent messages, and sending photos.-