dotiphant

Integrations

Connect Telegram to Claude

Install Dotiphant, let it archive your Telegram chats on your computer, then run dotiphant connect claude-desktop or dotiphant connect claude-code. Claude can then search and read your chats through Dotiphant's read-only MCP server.

claude.ai on the web and phone works too, through an HTTPS tunnel you run and an approval with a one-time pairing code.

Which Claude do you use?

Claude comes in a few forms, and they connect in two different ways. Claude Desktop and Claude Code run on your computer, so they can start Dotiphant themselves. claude.ai in the browser and the Claude mobile apps run on Anthropic's side, so they can only reach a server on the internet.

AppHow it connectsCommand
Claude DesktopLocal, starts Dotiphant over stdiodotiphant connect claude-desktop
Claude CodeLocal, added through the claude commanddotiphant connect claude-code
claude.ai, web and phoneRemote, through a tunnel you rundotiphant mcp --http --public-url URL

Claude Desktop and Claude Code

  1. Install Dotiphant and finish the setup in your browser. You create your own free API id at my.telegram.org, scan a QR code with the Telegram app, choose what to archive and run the first sync. The last setup step already offers to connect the AI apps it finds.
    curl -fsSL https://dotiphant.com/install.sh | sh
  2. If you skipped that step, connect Claude now. Without a name, dotiphant connect lists the apps and whether it found them.
    dotiphant connectdotiphant connect claude-desktopdotiphant connect claude-code
  3. Quit Claude completely and start it again. On macOS that means Cmd+Q, not just closing the window. For Claude Code, start a new session.
  4. Ask Claude something only your chats know, like "Summarize what happened in my groups since yesterday."

dotiphant connect claude-desktop writes a dotiphant entry into Claude Desktop's config file and keeps a backup of the old file. Add --dry-run to see the change first, or --print to get the snippet and paste it yourself. Claude Code is connected through its claude command; if that command is missing, Dotiphant prints the command to run later.

Claude Code and the terminal

In Claude Code you can also skip MCP and pipe a transcript straight in. dotiphant export prints a chat as Markdown:

dotiphant export "Acme" --since 7d | claude -p "What are the open action items?"

More on that in Export a Telegram chat to Markdown.

claude.ai on the web and phone

claude.ai only reaches MCP servers on the internet over HTTPS. Dotiphant still listens only on 127.0.0.1, so you put an HTTPS tunnel in front of it: ngrok, Tailscale Funnel or Cloudflare Tunnel.

  1. Start a tunnel to port 8766 and copy its https:// address.
    ngrok http 8766
  2. In another terminal, start Dotiphant with that address. It prints the pairing code. Leave it running.
    dotiphant mcp --http --public-url https://abc.ngrok.app
  3. In claude.ai, open Settings > Connectors and choose Add custom connector. On Team and Enterprise plans an owner adds it under Organization settings > Connectors.
  4. Enter a name and your tunnel address with /mcp at the end, like https://abc.ngrok.app/mcp. Choose Add, then Connect.
  5. The approval page opens. Check the return address: its host should be claude.ai. Then enter the pairing code and choose Approve, or run the dotiphant mcp --approve command the page shows.

Once added, the connector is also available in the Claude mobile apps. Menu names may differ between versions and plans. Every step, and how to manage or revoke access, is in the remote access docs.

What to know before you connect

  • Anthropic sees the messages Claude reads to answer you: text, sender names, chat names and dates. That is how any connector works, under Anthropic's privacy terms.
  • Dotiphant's tools only read. Claude cannot send, edit or delete anything in Telegram through Dotiphant. It can draft a reply for you; you send it yourself.
  • For claude.ai, your computer must be on and awake, with Dotiphant and the tunnel running. Stop both when you no longer need them.
  • Messages are marked as untrusted content for the AI. This lowers the risk of prompt injection but cannot rule it out.

When Claude does not see Dotiphant

Quit the app completely and start it again. Then run dotiphant doctor; it checks the installation and prints fixes. dotiphant status shows whether you are logged in and when the last sync ran.

dotiphant doctordotiphant status

Install Dotiphant

Free and open source (MIT). macOS and Linux; Windows experimental. The command installs the latest GitHub release and opens the setup in your browser. It takes about five minutes.

The script is about 150 lines. Read it first, or see other ways to install. The installer verifies the download against the release checksums (SHA256SUMS) before installing. You can check signed build provenance with gh attestation verify; see Verify a download.

curl -fsSL https://dotiphant.com/install.sh | shdotiphant open  # setup opens in your browser

Updated . Something wrong or unclear? Open an issue.