dotiphant

Integrations

Use your Telegram chats in Cursor and Codex

Run dotiphant connect cursor or dotiphant connect codex. It adds Dotiphant's read-only MCP server to the app's config, so the agent can search and read your Telegram archive while you code.

Both run locally: no tunnel, no account, nothing listening on your network.

Why your chats belong next to your code

A lot of product decisions never make it into a ticket. The API change was agreed in a group chat, the client sent the edge case in a private message, and the deadline moved in a thread from Tuesday. When your coding agent can read those chats, you can ask it to check the code against what was actually decided.

Dotiphant keeps a copy of your Telegram chats in one SQLite file on your computer. Cursor and Codex start its MCP server as a child process over stdio and call its tools: list chats, search messages, read a chat, recent activity, chat details and refresh. All of them only read.

Connect Cursor or Codex

  1. Install Dotiphant and finish the setup in your browser: your own free API id from my.telegram.org, a QR code login, what to archive, and the first sync.
    curl -fsSL https://dotiphant.com/install.sh | sh
  2. Connect the app. dotiphant connect without a name lists the apps it can connect and whether it found them.
    dotiphant connectdotiphant connect cursordotiphant connect codex
  3. Quit the app completely and start it again, so it loads the new server.
  4. Ask the agent a question that needs your chats.

For Cursor, Dotiphant writes a dotiphant entry to ~/.cursor/mcp.json. For Codex, it writes one to ~/.codex/config.toml. It keeps a backup of the old file. Add --dry-run to see the change first, or --print to get the snippet and add it yourself. To connect every app it finds at once, use dotiphant connect all.

Things to ask while you code

  • "What did we agree on in the Acme group about the new API rate limits?"
  • "Find the webhook URL Tomas sent me last month."
  • "Check this error message against what the client reported in our chat."
  • "Summarize what happened in the dev group since yesterday."

The agent will often search first, then read the part of the chat around the best match. If it seems to miss recent messages, ask it to refresh, or run dotiphant sync.

No MCP? Pipe Markdown instead

Any tool that reads text can use your chats. dotiphant export prints a chat as Markdown, and --out saves it to a file you can open in the editor or add to the agent's context:

dotiphant export "Acme" --since 7d --out acme.mddotiphant search "rate limit" --chat "Acme" --json

Be careful where that file ends up: a transcript in your project folder can be committed by accident. Details in Export a Telegram chat to Markdown.

Limits

  • The provider behind the app (Cursor, OpenAI) receives the messages its agent reads to answer you: text, sender names, chat names and dates. Only connect apps whose provider you trust with your chats.
  • Coding agents often have tools that run commands or edit files. Messages are marked as untrusted content and the AI is told not to follow instructions inside them, but no tool can rule out prompt injection. Review what an agent wants to run.
  • Dotiphant's tools cannot send, edit or delete anything in Telegram, so a tricked agent still cannot act in Telegram through Dotiphant.
  • If the app does not see Dotiphant, quit it completely, start it again and run dotiphant doctor.

More about the server and its tools: A local Telegram MCP server.

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.