the telegram mcp server

The Telegram MCP
for Codex & Claude.

A Model Context Protocol server that wires Codex straight into the Telegram app on your phone — read unread chats, search your messages and send replies across every account. Zero cloud storage.

On-device AI — always free Nothing stored server-side Multi-account
// works with every MCP client Codex Claude Desktop Claude Code Cursor Any MCP host
The Telegram MCP

Your phone does the work.
The cloud just relays.

BoB Chat exposes a Model Context Protocol server. Your AI client sends a tool call; it's relayed as a short-lived push to the app on your phone, which runs it against Telegram and sends the result straight back.

The round trip How one tool call travels MCPModel Context Protocol
AI Client · Codex / Claude
3 chats · 7 unread — Anna needs the report by 6pm · Dev Team moved the release to Thursday · Accounting sent an invoice.
FIG. 1
Your AI client — Codex or Claude — calls the MCP tool chat_unread() from plain language.
MCP Relay just forwards stores nothing
FIG. 2
A thin cloud pass-through. It forwards the request to your phone and stores nothing.
BoB Chat
Telegram · your account
AnnaNeed the report by 6pm?
Dev TeamRelease moved to Thursday
AccountingInvoice #2048 attached
runs it on Telegram · on your phone
FIG. 3
The BoB Chat app runs it on Telegram, right on your phone, and returns the result.
chat_unread()
request  AI → phone response  phone → AI
Your Telegram, your AI

A messenger with an AI that lives on your phone

BoB Chat is a full Telegram client first — folders, groups, channels, threads, up to 4 accounts. A multimodal model runs inside the app, so reply suggestions and catch-up summaries happen on your hardware. The on-device tier is always free.

Smart replies & summaries

Catch-up summaries of unread runs and three reply suggestions per chat — computed on your phone's GPU, even offline. Nothing is sent until you tap.

Works with BoB Tools

The cloud AI plugs straight into your bob.tools workspace via MCP — look up records, forms and data, or file new entries, right from the conversation.

Your AI at the controls

Wire Claude Desktop, Claude Code, Codex or any MCP client into your Telegram — read, search, summarise and send from your desk, across every chat and account.

Install

Pick your client

Same Telegram MCP server, every client. Codex is the smoothest; Claude Desktop is one click.

Point Codex at the hosted endpoint through the mcp-remote bridge. Add this to ~/.codex/config.toml and restart Codex — OAuth opens in your browser on the first call.

# ~/.codex/config.toml
[mcp_servers.bob_chat]
command = "npx"
args = ["-y", "mcp-remote", "https://api.bob.tools/mcp-chat"]
First run opens a browser — sign in with the same bob.tools account that's linked in the BoB Chat app.
Privacy

Your phone does the work

The relay is deliberately dumb. It carries a request to your device and a result back — and drops both.

Get started
Pricing

On-device AI is always free

Run the messenger, its on-device AI, a daily cloud AI allowance and 30 remote requests a day — for nothing. BoB Pro removes the caps; BoB Max is for the heaviest cloud-AI days.

One account for everything: your balance and your free daily AI limit are shared between BoB Chat and BoB Tools — and a Pro or Max subscription raises the limit in both apps.

Free

$0

On-device AI + a daily cloud allowance · Free forever

  • On-device AI — runs entirely on your phone, free forever
  • Free cloud AI every day — a daily allowance for smarter answers, just sign in; shared with BoB Tools
  • 30 remote requests a day from Claude Code, Claude Desktop or any MCP client — how to connect
  • Reply suggestions, catch-up summaries & channel briefs
  • Zero chat data stored — pure relay to your AI
Sign in & start free
For power users

BoB Max

$42.49/mo

Serious cloud AI, every day · 14-day free trial

  • Everything in BoB Pro
  • 20× the free daily AI limit for cloud AI in the app
  • Priority cloud AI — fastest responses at peak times
  • Works in BoB Tools too — the raised limit applies to both apps
  • For heavy multi-account & automation workflows
Get BoB Max

These are web prices — about 15% cheaper than subscribing inside the mobile apps, where store fees apply.
Prefer pay as you go? Top up your bob.tools balance instead — used only after your free daily allowance, with optional auto top-up. The same balance pays for BoB Tools usage.

FAQ

Telegram MCP, answered

The questions people ask before wiring an AI into their Telegram.

What is a Telegram MCP server?
An MCP (Model Context Protocol) server that exposes your Telegram to an AI client like Codex or Claude as a set of tools — read unread chats, search messages and send replies. BoB Chat relays each command to the app on your phone, which runs it against Telegram. Nothing is stored in the cloud.
Does the AI really run on my phone?
Yes. BoB Chat ships a multimodal Gemma 4 model that runs entirely on your phone with GPU acceleration. On the on-device model, reply suggestions and catch-up summaries work without sending a single message to the cloud — and the on-device tier is always free. The optional built-in cloud AI is a separate paid mode: turn it on and the messages for that request are sent to our servers to generate the reply.
Does the Telegram MCP work with Codex?
Yes — Codex is the client it works best with. Add the hosted endpoint to ~/.codex/config.toml via the mcp-remote bridge and Codex can read, search and reply across your Telegram accounts.
Does it work with Claude Desktop and Claude Code?
Yes. Claude Desktop installs the one-click .mcpb bundle; Claude Code adds it from the bob-tools/bob-plugins marketplace. Any MCP client — including Cursor — can also point at the hosted remote URL.
How do I connect Codex or Claude to Telegram?
Install the BoB Chat app and sign into Telegram, link your bob.tools account under Accounts → Remote control (MCP), then add the MCP server to your AI client and sign in with the same account. Run chat_overview to confirm the link. Full walkthrough in the setup guide.
Can the AI read my unread messages and search my chats?
Yes. BoB Chat logs in as your Telegram user account (not a bot), so it can read unread messages and search your entire history. Bot-API based Telegram MCP servers can't — Telegram's Bot API exposes neither message history nor search.
Can the AI send messages by itself?
On the Always Free plan — never. The on-device AI only suggests replies and builds catch-up briefs; nothing leaves your phone unless you tap send. On paid plans you can allow it to reply and follow up on your behalf — scoped by rules you define, per account and per chat type.
Where are my Telegram messages stored?
Your phone does the work. With remote control, the relay carries a short-lived command (≤60s) to your phone and the result back to your AI client, then drops both — message content passes through transiently rather than sitting in the relay. Details in the privacy policy.
Does it work across multiple Telegram accounts?
Yes. BoB Chat is multi-account, and the MCP tools work across every account you've added — scoped by what you allow per account and chat type (person, bot, group or channel). Up to 4 accounts.
How much does the Telegram MCP server cost?
The free plan includes on-device AI, a daily cloud AI allowance and 30 remote requests a day from Codex or Claude. BoB Pro (from $8.49/month on the web) unlocks unlimited remote control and 3× the free daily AI limit. BoB Max (from $42.49/month on the web) raises that to 20× with priority cloud AI. See pricing.
Is BoB Chat on iOS?
Yes — BoB Chat is live on both stores: Google Play for Android and the App Store for iPhone and iPad. Both run the very same on-device model.
Ready when you are

Give your AI a Telegram inbox.

Use the messenger and its on-device AI for free — then link your account and let Codex or Claude handle the catch-up.

Android & iOS · On-device AI always free · Nothing stored, ever

Now on both stores

BoB Chat is live on Android and iOS.

Grab BoB Chat for Android on Google Play or for iPhone and iPad on the App Store. Same app, same on-device AI, nothing stored on our servers.

Android & iOS — live in the stores today