Skip to main content
Glama
io.github.daedalus/mcp-telegram-bot

io.github.daedalus/mcp-telegram-bot

by daedalus

mcp-telegram-bot

MCP server that exposes a Telegram bot

PyPI Python Coverage Ruff

Install

pip install mcp-telegram-bot

Related MCP server: telegram-mcp

Setup

  1. Create a Telegram bot by talking to @BotFather on Telegram

  2. Get your bot token

  3. Set the TELEGRAM_BOT_TOKEN environment variable

Usage

export TELELEGRAM_BOT_TOKEN="your-bot-token-here"
mcp-telegram-bot

MCP 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 tools
get_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

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools use consistent snake_case and verb_noun pattern (get_me, get_updates, send_message), making them predictable.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      An 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.
      6
      10
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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 npm
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      -