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.

1 · Add BoB Chat to your AI

Pick your client — each takes one step. In the Claude app it’s a connector (works on web, desktop and mobile); 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 — web, desktop & mobile

Nothing to download. BoB Chat plugs in as a connector, right where the chat box is:

In the message box hit + → Connectors → Manage connectors.
Choose Add custom connector and paste the server URL below.
Sign in when Claude asks (step 3) — then flip BoB Chat on in the same + → Connectors menu.

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

Custom connectors need a paid Claude plan. Our other server, BoB Tools (forms, tables, dashboards), is listed in + → Connectors → Browse connectors — search “BoB Tools” and hit Connect. See the BoB Tools connector →

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

Terminal & other MCP clients — Cursor, Codex CLI

Claude Desktop — offline bundle

Only if custom connectors aren’t available to you: 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

Straight from our plugin repo. The connector above is the shorter path and always runs the latest tools.

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: your AI talks to our server, which forwards each request straight to the BoB Chat app on your phone. So link the phone too:

BoB Chat on your phone

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

The free plan covers 30 remote requests a day; BoB Pro lifts the cap. Get the app on Google Play or the App Store.

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 your devices — it calls chat_overview 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 →