mcpField
M
mcp-telegram-bot

mcp-telegram-bot

Local
github.com/daedalusCommunication1Updated 27w ago
Repository

About mcp-telegram-bot

mcp-telegram-bot exposes a Telegram bot through an MCP server. It is for MCP clients that need to send messages, check bot details, or retrieve recent updates.

Key features

  1. 01Send messages to Telegram chats
  2. 02Retrieve bot information
  3. 03Get recent Telegram updates
  4. 04Read bot status resource

Use cases

  1. 01Send a message to a Telegram chat
  2. 02Check the bot's information
  3. 03Retrieve recent updates from Telegram

MCP support

Exposes tools for sending messages, retrieving bot information and updates, plus a bot status resource to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
Run commanduvx mcp-telegram-bot

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-telegram-bot0.1.0

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
textstringYesThe message text to send.
chat_idstringYesThe Telegram chat ID to send the message to. Can be a numeric ID or username with @ prefix.

Details

From the project README

mcp-telegram-bot

MCP server that exposes a Telegram bot

PyPI Python Coverage Ruff

Install

pip install mcp-telegram-bot

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.