Search
launchFull-text search across all chats. Filter by chat and time.
A small open-source tool. Read-only. No cloud.
Dotiphant reads your Telegram, never writes to it, and keeps the archive in one file on your computer. Your AI assistant can answer from it. Set up in about five minutes.
curl -fsSL https://dotiphant.com/install.sh | shdotiphant open # setup opens in your browsermacOS and Linux; Windows experimental. The script (read it first) installs uv if needed, then the latest release from GitHub, checked against its published checksums (verify it yourself). Open source, MIT.
Your deals, partners and community live in Telegram.
Your AI assistant can't see any of it.
Dotiphant copies your chats into one file on your own computer, and lets the assistant read it when you ask.
Your assistant searches the archive, reads the messages around each hit, and answers with the chat, the sender, the date and the message id, so you can check.
Claude Desktop connected
On your computer, over MCP. One command: dotiphant connect claude-desktop.
Claude Desktop
What did we agree with Acme about the launch date?
You proposed the 28th, with the 4th as fallback if the security review slips. Maya Chen confirmed: "Works for us. Locking the 28th."
Illustration with made-up chats from dotiphant demo. Tool names are Dotiphant's real ones.


Dotiphant also works without an AI. dotiphant open gives you every archived chat in your browser.
launchFull-text search across all chats. Filter by chat and time.
People, groups, forum topics.Every chat your account can read, from the first message. Channels if you want them.
Copy last 7 daysSelect a few messages, or the last 7 days, and paste them anywhere: a doc, a ticket, any AI chat.
Settings > Devices > Link Desktop DeviceScan a QR code with the Telegram app. The login stays in your system keychain.
dotiphant connect cursorThe setup connects the AI apps it finds on your computer. Restart the app, and ask.
Export a chat in WhatsApp (Export chat) and import the file. It joins the same archive, search and AI tools. Nothing connects to WhatsApp.
No account with us. No server to run. The setup is a page in your browser.
Install Dotiphant with the install script, then dotiphant open starts the setup in your browser and brings the viewer back later. You create your own free Telegram API id at my.telegram.org; it takes about a minute.
In the Telegram app, go to Settings > Devices > Link Desktop Device, and point your phone at the code. Choose what to keep: people and groups by default, the last 365 days or everything. The first sync starts.
The setup connects the AI apps it finds on your computer. Or run dotiphant connect claude-desktop (or claude-code, codex, cursor), restart the app, and ask.
Not comfortable with a terminal? Give install-with-ai.md to Claude Code, Codex or another AI assistant that can run commands, and it will install Dotiphant with you.
Your chats stay on this computer. No cloud, no telemetry. Here is exactly what lives where.
01
02
03
dotiphant ai hide CHAT, or the toggle in the viewer, or switch to dotiphant ai mode selected to share only the chats you choose.dotiphant ai limits what they can see. Claude Desktop, Claude Code, Codex and Cursor need no tunnel. Remote accessThe stored session gives full access to your account, like a logged-in Telegram Desktop. Protect your computer like you protect your phone: screen lock and disk encryption. To wipe everything, stop the refresh, log out with --forget-credentials and delete the data folder. Steps are in the security guide. Your archive also holds other people's messages. If you use Dotiphant for work, data protection law (such as the GDPR) likely applies, so ask your data protection officer first.
One archive on your computer. Every app below reads the same file, over MCP.
Over MCP. The app starts Dotiphant itself; nothing listens on the network.
connect claude-desktopconnect claude-codeconnect codexconnect cursorWith ngrok, Tailscale Funnel or Cloudflare Tunnel. This is the riskiest path, because it exposes your archive through a tunnel you run. You approve each app yourself, with a terminal command or a one-time pairing code that only your terminal shows, and dotiphant ai limits which chats it can read. No need for a remote app? The local apps above need no tunnel.
mcp --httpweb and phonemcp --httpThe usual ways to get Telegram into an AI or a CRM, in general terms. Individual products vary.
| Question | Dotiphant | Bot-based tools | Cloud CRMs |
|---|---|---|---|
| Sees your full history | Yes, every chat your account can read, except secret chats | No, only messages after the bot is added | Usually yes |
| Data stays on your computer | Yes, one SQLite file | Usually no | No, stored on their servers |
| Your login stays with you | Yes, in your OS keychain | No login needed, so no history | No, the session lives on their servers |
| Works with your AI assistant | Yes, over MCP | Varies | Some, through their own tools |
| Open source | Yes, MIT | Usually not | Usually not |
| Setup time | About 5 minutes | Minutes, then add the bot to each group | Minutes |
| Price | Free | Often a subscription | Usually per seat, per month |
Scroll the table sideways to see every column.
dotiphant demo opens the viewer on a made-up archive: Acme x Northwind, Priya Raman, Kestrel Protocol Builders and a few more. No login, no API keys. It's stored apart from your real data and runs on its own port, so it can sit next to dotiphant open.
Prefer your real chats without logging in? dotiphant import reads a Telegram Desktop JSON export.
dotiphant demoDemo data lives in its own folder and is separate from your own archive.Dotiphant viewer at http://127.0.0.1:8764 (Ctrl+C to stop)# Any chat as Markdown, straight into another tooldotiphant export "Acme" --since 7d | claude -p "What are the open action items?"More in the FAQ on GitHub, or ask in Discussions.
A bot is a separate Telegram identity. It only sees messages sent after it was added to a group, never the history before that, and it can't read your private chats unless people message the bot directly.
Your own account already sees everything you see: every one-on-one chat, every group, from the first message. Dotiphant logs in the way Telegram Desktop does and reads that, so your assistant gets the full context from day one.
Dotiphant logs in the same way Telegram Desktop does, only reads, and slows down whenever Telegram asks. Read-only, paced use of your own account is what the API is meant for. No third-party client can promise zero risk, though: brand new accounts and accounts with spam reports are watched more closely. Use your own API id and hash, and don't run several archivers on one account at once.
No. Secret chats are end-to-end encrypted between two devices and never reach Telegram's servers in readable form, so no other app can read them.
Yes, through a tunnel you run. ChatGPT and claude.ai on the web and phone only talk to servers on the internet. Run dotiphant mcp --http behind ngrok, Tailscale Funnel or Cloudflare Tunnel, add the address as a connector, and approve it in your terminal or with a one-time pairing code. Custom connectors in ChatGPT need a paid plan. Remote access is the riskiest path, since it exposes your archive through a tunnel you run; limit what remote apps can see with dotiphant ai. Claude Desktop, Claude Code, Codex and Cursor work locally with dotiphant connect and need no tunnel. Step by step: Connect Telegram to ChatGPT.
The messages your assistant reads to answer you: text, sender names, chat names and dates. They go to that app's provider under its privacy terms, like anything you paste into it. Dotiphant can't control what happens after that. It never sends your archive anywhere on its own.
Yes. You decide which chats your AI may read. Hide any chat from AI apps with dotiphant ai hide CHAT, or the toggle in the viewer, or switch to dotiphant ai mode selected to share only the chats you choose.
The people in your chats did not choose Dotiphant, so keep the archive for your own use. If you use it for work, data protection law (such as the GDPR in the EU) likely applies; ask your data protection officer first. More in the security guide.
Yes. Dotiphant is a command-line tool. Setup itself runs in your browser, and an AI assistant that can run commands can install it with you.
Dotiphant syncs Telegram. For WhatsApp, export a chat in the WhatsApp app (Export chat) and run dotiphant import on the file: the chat joins the same archive, search and AI tools. Nothing connects to WhatsApp. A live WhatsApp link is not supported: WhatsApp has no official API for personal accounts, and an unofficial one may put your account at risk. Signal and Slack are not supported.
Dotiphant is free and open source under the MIT license, including remote access through your own tunnel. Your Telegram API id is free too.
No. Dotiphant is an independent, unofficial project, not made, endorsed or supported by Telegram. It uses the public Telegram API with API credentials you create yourself, so you are responsible for using it within the Telegram API Terms of Service. Dotiphant does not train AI models. Using Telegram data with AI apps is subject to the Telegram API Terms of Service and the Terms for Content Licensing and AI Scraping. Check them before you connect an AI app; you are responsible for how you use your archive.