dotiphant

Now your AI assistant can search your Telegram.

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 browser

macOS 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.

Ask once.
It answers from your chats.

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.

01

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?

  1. dotiphant.search_messages(query_text="launch", chat="Acme")
  2. dotiphant.get_messages(chat="Acme", around_message_id=111)

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.

The Dotiphant viewer in a browser: the Acme x Northwind integration group chat, with two messages about the launch date selected and a 'Copy as Markdown' button at the bottom.The Dotiphant viewer in a browser: the Acme x Northwind integration group chat, with two messages about the launch date selected and a 'Copy as Markdown' button at the bottom.
The viewer runs on your computer and is reachable from it only. Pick messages and copy them as Markdown, search every chat, or let your assistant do the reading.

One archive. Many ways in.

Dotiphant also works without an AI. dotiphant open gives you every archived chat in your browser.

Search

Search results for 'launch' across chats, with the matching word highlighted in each message.launch

Full-text search across all chats. Filter by chat and time.

Chats

Chat list in the Dotiphant viewer: Acme x Northwind integration and Priya Raman starred as favorites, then Lumen Wallet partners, Helios Labs and Orbit Ventures, Kestrel Protocol Builders and more, with message counts.People, groups, forum topics.

Every chat your account can read, from the first message. Channels if you want them.

Copy as Markdown

Two messages selected in the Acme x Northwind integration chat, with a Copy as Markdown button.Copy last 7 days

Select a few messages, or the last 7 days, and paste them anywhere: a doc, a ticket, any AI chat.

Log in

Dotiphant setup page, step 2 of 5: Log in to Telegram, with a QR code and numbered instructions to open Settings > Devices > Link Desktop Device.Settings > Devices > Link Desktop Device

Scan a QR code with the Telegram app. The login stays in your system keychain.

Connect

Dotiphant's Connect AI page listing one command each for Claude Desktop, Claude Code, Codex and Cursor, with example questions below.dotiphant connect cursor

The setup connects the AI apps it finds on your computer. Restart the app, and ask.

WhatsApp import

dotiphant import

Export a chat in WhatsApp (Export chat) and import the file. It joins the same archive, search and AI tools. Nothing connects to WhatsApp.

Three steps, about five minutes.

No account with us. No server to run. The setup is a page in your browser.

  1. 01

    Install and open

    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.

  2. 02

    Scan the QR code

    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.

  3. 03

    Ask your assistant

    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.

Read-only toward Telegram.
No cloud in between.

Your chats stay on this computer. No cloud, no telemetry. Here is exactly what lives where.

01

Stays on your computer

Your messages
One SQLite file in a private folder that only your user account can read.
Your Telegram login
The session, API id and hash sit in the system keychain. You can end the session any time in Telegram under Settings > Devices.
The viewer
Listens on 127.0.0.1 only, and every request needs a key that is unique to your install.
No training
Dotiphant never uses your messages to train AI models, and its makers never receive them.

02

Toward Telegram: read only

Never writes
Dotiphant never sends, edits, deletes, forwards or reacts, never joins or leaves chats and never marks anything as read.
Paced
Requests are paced, and Dotiphant waits whenever Telegram asks it to slow down.

03

What your AI provider sees

Only what it reads
When you ask a question, the messages your assistant reads go to its provider (Anthropic, OpenAI, Cursor), the same as anything you paste in. Connect only apps you trust with your chats.
Your choice of chats
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.
Remote access
ChatGPT, claude.ai and other remote apps need a tunnel you run, which makes your archive reachable from the internet. It is the riskiest path: every app needs your approval, and dotiphant ai limits what they can see. Claude Desktop, Claude Code, Codex and Cursor need no tunnel. Remote access
Untrusted by default
Every message is fenced as untrusted content, and the AI is told not to follow instructions inside it. That lowers the risk of prompt injection; no tool can rule it out. Dotiphant's tools can't send anything, so a tricked AI can't act in Telegram through Dotiphant.

The 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.

Works with the assistant you already use.

One archive on your computer. Every app below reads the same file, over MCP.

On your computer, one command

Over MCP. The app starts Dotiphant itself; nothing listens on the network.

  • Claude Desktopconnect claude-desktop
  • Claude Codeconnect claude-code
  • Codexconnect codex
  • Cursorconnect cursor

Remote, through a tunnel you run

With 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.

  • ChatGPTmcp --http
  • claude.aiweb and phone
  • Other remote MCP appsmcp --http
  • Custom connectors in ChatGPT need a paid plan.

How it compares.

The usual ways to get Telegram into an AI or a CRM, in general terms. Individual products vary.

QuestionDotiphantBot-based toolsCloud CRMs
Sees your full historyYes, every chat your account can read, except secret chatsNo, only messages after the bot is addedUsually yes
Data stays on your computerYes, one SQLite fileUsually noNo, stored on their servers
Your login stays with youYes, in your OS keychainNo login needed, so no historyNo, the session lives on their servers
Works with your AI assistantYes, over MCPVariesSome, through their own tools
Open sourceYes, MITUsually notUsually not
Setup timeAbout 5 minutesMinutes, then add the bot to each groupMinutes
PriceFreeOften a subscriptionUsually per seat, per month

Scroll the table sideways to see every column.

Try it without Telegram.

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?"
Why log in as me instead of using a bot?

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.

Can my account get banned?

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.

Are secret chats included?

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.

Does it work with ChatGPT?

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.

What does the AI provider see?

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.

My chats include other people's messages. Can I keep some away from AI?

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.

Do I need to use the terminal?

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.

What about WhatsApp, Signal or Slack?

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.

What does it cost?

Dotiphant is free and open source under the MIT license, including remote access through your own tunnel. Your Telegram API id is free too.

Is Dotiphant made by Telegram?

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.