Telegram Plugin: Overview & Toolset

⏱ Est. reading time: 3 min Updated on 5/7/2026

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.

Telegram Interaction

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.