Setup guide

Connect your AI to Telegram

Wire Claude Desktop, Claude Code or any MCP client into your Telegram. Your AI reads, searches, summarises and replies — while everything runs on your own phone. We never store your chats.

1 · Add BOB Chat to your AI

Start on your computer. Pick your client — each takes one step. Claude Code and Codex share the same plugin marketplace: bob-tools/bob-plugins.

Codex

In the Codex app: Plugins → + → Add marketplace. Paste the source below (Git ref main, Sparse paths can stay empty), then add BOB Chat from the Personal tab.

bob-tools/bob-plugins
Add the marketplace, then install BOB Chat from Personal

Claude Code

Add the marketplace once, then install the plugin:

/plugin marketplace add bob-tools/bob-plugins
/plugin install bob-chat@bob-tools/bob-plugins

Connects over HTTPS — no npm needed. Sign in when prompted (step 3).

Claude Desktop

Download the bundle and double-click it — Claude Desktop installs the server and shows a settings form. No Node or terminal needed.

Download bob-chat.mcpb

Always the latest build, straight from our plugin repo. On a paid plan you can instead add a custom connector for https://api.bob.tools/mcp-chat.

Terminal & other MCP clients — Cursor, Codex CLI

Cursor & other MCP clients

Add a remote (HTTP) server — OAuth signs you in on first use:

https://api.bob.tools/mcp-chat

Codex (CLI)

Point Codex straight at the remote server — it fetches the tools live, so you always have the latest (no re-install; just reconnect after an update). Add to ~/.codex/config.toml:

[mcp_servers.bob-chat]
url = "https://api.bob.tools/mcp-chat"

OAuth signs you in on first use. Pointing at the URL means tool updates land automatically — no re-install, just reconnect. (Remote/HTTP MCP needs a recent Codex build; on an older one use the stdio option below.)

2 · Link your phone

BOB Chat is a relay: the AI on your computer talks to a small local server, which forwards each request to the BOB Chat app on your phone. So link the phone too:

BOB Chat on your phone

  1. Install BOB Chat (Android) and sign into Telegram.
  2. Open Accounts → Remote control (MCP) and sign in to your bob.tools account (one-time email code).
  3. This links the phone as a chat-control device for that account.

Remote control needs a paid BOB Chat plan. Get the Android app on Google Play.

3 · Sign in

The first time your AI uses a tool, a browser opens to sign in to bob.tools — your client handles the OAuth automatically (in Claude Code you can also run /mcp → Authenticate). Sign in and you're done; tokens are saved and refresh automatically.

Use the same account
  • Sign in with the same bob.tools account you linked in the app
  • That match is how the server routes a command to your phone

4 · Confirm the link

Ask your AI to list devices — it calls chat_list_devices and you should see your phone. Then try it out:

Prefer the browser? See & manage your linked devices and accounts → — your plan, the account limit and every phone linked to your bob.tools account.

Catch up

"Summarise my unread Telegram chats"

Reply

"Tell Anna I'll be 10 minutes late"

Search

"Find that invoice link someone sent me last week"

Private by design — nothing stored on our servers

Every request is fetched live from your phone, passed to your AI, and forgotten — held for seconds, never saved. That also means your phone has to be online. See plans & pricing →