Telegram Plugin: Overview & Toolset
The Telegram plugin is a community-driven alternative that connects Claude Code to Telegram. It is an open-source plugin from claude-plugins-official, powered by a local MCP server running on Bun.
How it Works
It logs into a Telegram bot you create and converts inbound messages into <channel> notifications for the agent. The agent can then reply or react using MCP tools.

Exposed Tools
| Tool | Purpose |
|---|---|
reply |
Sends a message to a chat. Supports chat_id, text, reply_to, and file attachments. |
react |
Adds an emoji reaction. Only specific Telegram emojis are allowed (👍, ❤, 🔥, 👀, etc.). |
edit_message |
Edits a previously sent bot message. Great for status updates like "Working..." → "Done". |
Key Differences from Remote Control
- Remote Control: Moves the client to the cloud. You see the full transcript.
- Telegram Plugin: Connects an IM app to the agent. You see chat bubbles – it's more fragmented and IM-like.
- History: Telegram Bot API does not provide chat history. The bot only sees messages received after it started.