telepathTHE SETUP GUIDE
Your Telegram,
in your assistant.
Connect Telepath, sign in with Telegram, then choose which chats to share. Already done one step? Pick up where you left off.
Questions? Read the FAQ for groups, permissions, imports and more.
Telegram Premium is not required. Set up once, then use your connected chats across devices.
Your assistant
Connect your assistant
Choose your assistant below. If you have already connected it, go to Telegram chats.
Open the Telepath listing in ChatGPT to connect your assistant.
Open the app and install it
Go to the Lemma Telepath app and press Install plugin. ChatGPT wires the connector up itself — no address to copy, no form to fill in.
Show screenshot
Connect Lemma Telepath
ChatGPT shows what the app may see and asks you to confirm. Press Connect Lemma Telepath — this opens the Telepath sign-in page.
Show screenshot
Sign in with Telegram
On the Telepath sign-in page, choose Sign in with Telegram. Follow Telegram’s prompts and use the account whose chats you want to share.
After confirming, return to the original sign-in window to finish, then go back to your assistant. Phone and computer tips →
Connect your chats, then try it
Finish connecting your Telegram chats, then ask your assistant:
- “Show me my most recent Telegram chats.”
- “Find the message where we agreed the invoice amount.”
- “Summarise what I missed today.”
No messages yet? New messages from your selected chats arrive after you connect. Ask someone in a selected chat to send you a message, then try again. Older history can be imported separately.
No apps in your workspace? Some plans still hide the
directory. Then add it by hand: at chatgpt.com/plugins
press + in the top right, choose Create app, then Create MCP
App in the bottom-left corner. Name it Lemma Telepath, keep
Server URL and paste https://telepath.lemma.company/mcp,
set Authentication to OAuth, tick I understand and want to
continue and press Create. Step 3 above carries on from there.
Telepath is in Claude's own directory, so there is nothing to paste.
Open the listing and press Connect
Go to claude.ai/directory/lemma-telepath and press Connect to Claude. Claude adds the connector itself — no address to copy, no settings to fill in.
Show screenshot
Sign in with Telegram
On the Telepath sign-in page, choose Sign in with Telegram. Follow Telegram’s prompts and use the account whose chats you want to share.
After confirming, return to the original sign-in window to finish, then go back to your assistant. Phone and computer tips →
Add the plugin
Optional, and free: the connector gives Claude access, the plugin teaches it what to do with it. Four skills come with it — catching up on what arrived, briefing one conversation, drafting a reply in your own voice, and repairing the connection when something breaks.
Open the Telepath plugin and press Add. Nothing else to do — the connector you just signed into stays as it is, and the skills start working in the next conversation.
Show screenshot
Installed the plugin first? Then the connector is sitting switched off inside it, and nothing in Claude points at the place where you turn it on. Open Customize → Plugins → Telepath → Connectors: the connector there reads “Not added”, with a Connect button. Press it, then Continue, then Add on the screen after that — leaving Register automatically as it is — and the Telegram login opens. The listing above does the same in one press, so it is the easier way round: connect there first, add the plugin afterwards for its skills.
The Grok directory listing is coming soon. If your Grok account supports custom MCP connectors, you can use the manual setup below.
Open Plugins
In the Grok sidebar at grok.com choose Plugins. Anything you connect lands in that same list.
Show screenshot
New Connector
On the Connectors tab, press New Connector — top right, next to the search box.
Show screenshot
Choose Custom
The list that opens is the built-in catalogue. Telepath is not in it — take the first entry, Custom.
Show screenshot
Name it and paste the server
Any name you like, then the address:
https://telepath.lemma.company/mcp
Press Add Connector.
Show screenshot
Sign in with Telegram
On the Telepath sign-in page, choose Sign in with Telegram. Follow Telegram’s prompts and use the account whose chats you want to share.
After confirming, return to the original sign-in window to finish, then go back to your assistant. Phone and computer tips →
Gemini CLI, Claude Code, Cline, Codex, Cursor and anything else that speaks MCP. There is no settings screen — you tell the agent, and it wires itself up.
Give it this
Paste it as-is. Any MCP-capable agent has everything it needs here:
Some agents have a one-liner instead, and you can skip the paragraph above.
Gemini CLI — a published extension, so this pulls the manifest for you:
Claude Code
Cline
Codex — the first command already prints the login link:
Restart the agent afterwards, then finish the browser login in step 2. In Claude Code the sign-in prompt is /mcp; in Cline it is cline mcp → Authorize OAuth; in Codex it is codex mcp login telepath. There is a Telepath plugin for some of these, but none of them need it — the MCP server above is the whole product.
Finish the sign-in in a browser
Open the sign-in URL on the computer running your agent. Choose Sign in with Telegram and follow Telegram’s prompts. If you confirm on your phone, return to the original browser window on your computer to finish. Then return to your agent. Sign-in help →
Check it sees the tools
Ask it to list its tools. You should see the telegram_* and kb_* set — searching, reading messages and files, and, if you granted it, replying.
One sign-in. Your Telegram account.
- Start Connect from Telepath in your assistant.
- On the Telepath page, choose Sign in with Telegram and follow Telegram’s prompts.
- Finish in the original sign-in window, then return to your assistant.
Signing in identifies your account. Sharing your chats is a separate step below.
On a phone or using two devices?
On your phone: if Telegram opens during sign-in, confirm there and return to the same browser tab or sign-in window opened by your assistant.
Computer + phone: start from the assistant on your computer. If Telegram asks you to confirm on your phone, do so, then finish in the original computer window.
Closed the window or got stuck? Open Telepath in your assistant and start Connect again. Use the new sign-in page instead of an old link from the bot.
Seeing “Open Telegram” or a bot code instead?
You’re on the alternative sign-in flow. Follow that page’s instructions: open the bot, tap Start if shown, and approve the connection you just requested. Return to the original sign-in window and choose Continue if shown. If the link expired, restart from your assistant.
Telegram chats
Add the bot in Telegram
Where are you setting up Telegram? Choose your app. After setup, you can use your connected chats from any device.
Android
- Open Telegram settings below, then choose Chat Automation.
- Add @lemma_telepath_bot and select the private chats you want to share.
- Tap ✓ (Done) to save.
Button didn’t open the right screen? Update Telegram, then go to Settings → Account → Chat automation.
iPhone / iPad
- Open Telegram settings below, then choose Chat Automation.
- Add @lemma_telepath_bot and select the private chats you want to share.
- Go Back to save the connection.
Button didn’t open the right screen? Update Telegram, then go to Settings → Edit → Chat Automation.
Telegram Desktop · Windows, Linux or Mac
- Open Telegram settings below, then choose Chat Automation.
- Add @lemma_telepath_bot and select the private chats you want to share.
- Go Back to save the connection.
Button didn’t open the right screen? Update Telegram, then go to Settings → ⋮ → Edit profile → Chat automation.
Telegram Web
Check the address bar: /k/ means Web K; /a/ means Web A.
Web K: open Settings → Edit profile → Chat Automation. Add @lemma_telepath_bot, choose private chats, and save your changes.
Open Telegram Web K ↗Using Web A? Set up in Web K or on your phone with the same Telegram account, then return to Web A.
Telegram for macOS · native Mac app
For this step, use Telegram on your phone, Telegram Desktop, or Web K with the same account. Set up once, then return to your usual Mac app.
Set up in Web K ↗Use the same Telegram account you signed in with. Save the change in Telegram before returning to your assistant. Opening the bot or checking your status alone does not connect private chats.
Already added the bot, but still not connected?
Send /setup in the bot to check your status. Confirm that your chosen chats are included and that you saved the connection. Telegram allows one chat automation bot at a time.
For replies, enable Bot permissions → Manage Messages → Reply to Messages. Manage Profile, Manage Gifts and Stars, and Manage Stories are not needed.
Get human help ↗New messages from your selected 1:1 chats will be archived after connection. Older messages are not imported automatically. If your assistant is also connected, return to it and ask about a new message.
Starting with an empty history is normal. Telepath saves new messages after you connect your chats. To add older conversations, send /import in this bot.
After that
Everything else is optional, and lives in the bot's own chat:
/settings— switch individual capabilities on and off. Replies, media, notes and group archiving are each a toggle you control./import— backfill older history from a Telegram Desktop export. The bot only sees messages sent after it was connected, so this is how you bring in the past. How →/reminders— view and cancel reminders. Ask your assistant to create one. Free includes 3 new reminders per day (UTC), shared with task reminders; Plus and Unlimited have no daily creation limit./subscribe— your plan and minute balance. Plus costs 200 Stars every 30 days: 500 voice/video transcription minutes per paid period, 50,000-message history import, task reminders and priority support. Unlimited costs 600 Stars every 30 days: unlimited transcription while active, 250,000-message history import, your own bot, task reminders and AI auto-reply with your own OpenAI key (API billed separately). Configure auto-reply from Main menu → Auto-reply; choose your model, context, chats and instructions, test, then enable. Subscriptions renew automatically; cancel renewal in Telegram. Unused minutes carry over./minutes— one-time packs: 100 minutes for 25 Stars, 500 for 100 Stars, or 1,500 for 250 Stars. Purchased minutes never expire while your account exists, even without an active Plus plan./deletedata— erase everything we hold for you, immediately.
Your Notes workspace
Telepath Notes is free on every plan. Open Notes from the bot’s menu to create notes, projects, tasks and people pages. Connect pages with [[Page title]] and keep track of next steps with checklists.
Your connected assistant can read, search, create and update these same pages when Notes access is enabled. Try: “Save our next steps as a Telepath note.” Your workspace starts empty; examples are added only when you choose them.
Importing your old history — the full walkthrough
The bot starts seeing messages the moment you connect it, and cannot look further back — Telegram simply doesn't offer that. An export fills in what came before.
Free includes 5,000 imported messages, Plus 50,000, and Unlimited 250,000. Shared across all uploads; renewals do not reset usage. Preview and confirm the newest messages that fit. Duplicates and live messages do not count. Previously granted extras are preserved and existing history is never deleted. Want more? View plans.
Open Advanced in Telegram Desktop
This lives in the desktop app only — the phone app has no export. Settings → Advanced, then Export Telegram data at the very bottom.
Show screenshot
Show screenshot
Untick all the media
Photos, videos, voice messages, stickers, files — none of it is needed. We import the text and the structure of your conversations, not the files, and leaving these on turns a small export into tens of gigabytes.
Show screenshot
Choose Machine-readable JSON
At the bottom, under Location and format. This is the one setting that must be right — HTML cannot be imported, and picking it means exporting all over again.
Show screenshot
Telegram then prepares the file. A long history can take a while, and Telegram may make you wait before it starts.
Upload your history
In the bot press 📥 Import history (or send /import). Tap Upload history, choose result.json, then press Import history. We automatically import the newest messages that fit your remaining message allowance. No plan purchase is needed to start.
Wait for it to finish — the bot messages you a receipt with how many messages went in.
What people ask
- Will it overwrite what I already have? No. Messages are matched on chat and message id, and anything already there is left alone — a live message always wins over the same message from an export. Importing the same file twice changes nothing.
- Can I import just one chat? Yes. Right-click the chat in Telegram Desktop → Export chat history, same JSON format. Both a single chat and a whole-account export are accepted.
- What about groups? They import too, and their ids are converted so they line up with live traffic instead of producing duplicates.
- Will the voice messages be transcribed? No. An export carries no file Telegram can still hand us, so imported voice stays as it is. Transcription works on new messages.
- How big can it be? Free: 5,000 imported messages. Plus: 50,000. Unlimited: 250,000. Shared across all chats and uploads; renewals do not reset usage. Every plan can upload JSON files up to 1,200 MB. Preview and confirm the newest messages that fit your remaining allowance. Duplicates and live messages do not count. Existing history is never deleted. For larger files, export fewer chats or a shorter date range.
- Is the link safe? It is single-use, expires after 24 hours, and belongs to you alone — the bot already knows who you are, so there is nothing to log in to.
If something does not work
- The assistant says it has no connection. Return to your assistant’s setup and finish sign-in. Adding the bot in Telegram alone does not connect your assistant.
- It can read but not reply. Reply to Messages is off in the bot's permissions (step 2). Telegram also only allows a connected bot to write to someone within 24 hours of their last message to you.
- A chat is missing. It may be excluded in step 2, or the messages predate the connection — see
/import.
Still stuck? Get human help from our team. Tell us which assistant you are connecting and what you see.