Build a Telegram bot with Claude
Describe a bot to Claude and it builds the flow straight into your TeleBotBuilder account. Every flow it makes is an ordinary flow that you can open, test and change in the visual editor.
Before you start, sign in to TeleBotBuilder with Google and connect at least one Telegram bot with the token @BotFather gives you. Claude can build on any bot connected to your account.
The connector address
https://api.telebotbuilder.com/mcp
Add the connector to Claude
Claude on the web and the desktop app
- Open Customize, then Connectors.
- Press Add, then Add custom connector.
- Paste
https://api.telebotbuilder.com/mcpas the URL and add it. Any name works, for example TeleBotBuilder. - Press Connect. A TeleBotBuilder page opens: sign in with Google if you are not signed in already.
- Read what Claude asks for and press Allow. You are sent back to Claude, and the connector is ready.
In a Claude Team or Enterprise organization, an owner adds the connector in the organization settings first; members then press Connect.
Claude Code
Add the server from your terminal:
claude mcp add --transport http telebotbuilder https://api.telebotbuilder.com/mcp
Then run /mcp inside Claude Code, pick telebotbuilder and sign in. Your browser opens the same TeleBotBuilder page: sign in with Google and press Allow.
Prompts to try with Claude
Tip: name the bot when you have more than one, for example "on @mybakerybot".
Example: a booking bot, start to finish
Which bots do I have?
Two: @mysalonbot with three flows and @mytestbot with one.
On @mysalonbot, make a /book flow: buttons for haircut, colour and nails, then buttons for Monday to Saturday, then a thank-you message.
I checked the flow before saving it and found no problems. It is saved as a new flow called Booking, started by /book.
Add Sunday as well.
Added. I kept a copy of the flow from before this change; say undo if you want it back.
An example of how it goes; Claude's exact words vary.
What Claude can see and do
On the sign-in page you choose what Claude may do. With both Read and Write allowed, it can:
- List your bots and their flows.
- Read a flow, in the same blueprint format it writes.
- Create a flow or change one, after a check that lists every problem before anything is saved.
- Undo a change by bringing back the copy saved before it.
- Add a ready-made template to a bot.
- Show simple counts, such as how many contacts a bot has.
What it can never do. It can never delete bots or flows, send messages or broadcasts, see your contacts or their messages, see your bot tokens or touch payments. Keys and passwords inside a flow show as placeholders such as <<YOUR_API_KEY>>, and your real value is kept.
What it builds follows the same limits as the editor. Some blocks need a Pro or trial account.
Disconnect Claude
On the website, open Settings and find Connected AI apps. On a phone and in the Android app it is in Profile. Press Disconnect and confirm: the app loses access at once, and your bots and flows stay as they are.
You can also remove the connector inside Claude. Disconnecting in TeleBotBuilder is what ends its access on our side.
Questions
Does it work in Claude Code?
Yes. Run claude mcp add --transport http telebotbuilder https://api.telebotbuilder.com/mcp, then /mcp, pick telebotbuilder and sign in with Google.
Can everyone in my Claude organization use it?
In a Claude Team or Enterprise organization an owner adds the connector first. Each member then presses Connect and signs in with their own TeleBotBuilder account.
Will Claude see the people who use my bot?
No. Claude works on your flows only. It never sees your contacts or their messages, and it cannot send messages or broadcasts.
More about the connector
TeleBotBuilder is an independent product and is not affiliated with OpenAI or Anthropic.