telegram-mcp 0.2.0

MCP server for Telegram - lets AI agents communicate with users via Telegram

Telegram MCP

MCP server that lets AI agents communicate with users via Telegram.

Installation

pip install telegram-mcp

Configuration

Add to your MCP client config:

{
  "telegram": {
    "command": "telegram-mcp",
    "env": {
      "TELEGRAM_BOT_TOKEN": "your-bot-token",
      "TELEGRAM_CHAT_ID": "your-chat-id"
    }
  }
}

Get Your Credentials

1. Create a bot via @BotFather → copy the token
2. Message your bot, then get your chat ID from @userinfobot

Tools

interact

Send a message to the user via Telegram.

# Status update
interact(message="Working on it...")

# Ask a question (blocks until user replies)
result = interact(message="What's next?", wait_for_reply=True)

# Yes/No with buttons
result = interact(message="Delete?", choices=["Yes", "No"], wait_for_reply=True)

get_messages

Get recent conversation history.

result = get_messages(limit=10)

License

MIT