Telegram Business Bridge — AI skill for Claude Code

telegram-business-bridge

**Connect any AI agent to your personal Telegram messages — through the official Telegram Business API.** No userbot, no MTProto session, no risk of losing your account.

Your agent reads the conversation history, searches it, drafts replies — and by default every reply waits for your ✅ in Telegram before it is sent. Works with Claude Code and any other MCP client. **No Telegram Premium required** — despite the "Business" name, the connection works on a regular free account (verified on a real one).

🇷🇺 [Русская версия](README.ru.md) · 🤖 [Instructions for AI agents](AGENTS.md)

The pains this solves

**"I want an AI assistant in my personal Telegram, but userbots get accounts banned."** The usual way to automate a personal Telegram account is a userbot — Telethon, Pyrogram, a TDLib wrapper — that logs in *as you*, with your session. Telegram actively bans accounts for that. And it is your *personal* account: your channels, your contacts, years of chats. One ban and it is all gone, with no appeal that reliably works. This bridge never touches your session. It is a regular bot connected through the official [Telegram Business API](https://core.telegram.org/bots/api#business-messages): Telegram itself hands your personal chats to the bot, by your explicit permission, switchable off in Settings at any moment. There is simply nothing to ban you for.

**"I'm afraid to let an AI send messages as me."** Reasonable. By default the agent can only *draft* a reply. You get a card in Telegram with the text and two buttons — ✅ Send / ✏️ Edit. Nothing leaves without your tap, and if the wording is almost-but-not-quite right, you fix it in an editor window right inside Telegram instead of retyping the whole reply. Auto-send is strictly opt-in: enable it per chat (`BRIDGE_AUTO_SEND_CHAT_IDS`) for the conversations you genuinely trust the agent with, or globally (`BRIDGE_SEND_POLICY=auto`) once you are sure.

**"My agent forgets who these people are