Telegram

Send and read Telegram messages programmatically.

Works with: Claude Desktop

Community server · details last checked

Quick install
npx -y telegram-mcp

How to install the Telegram MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-mcp"
      ]
    }
  }
}

Built by ContextBoltThis directory is built by ContextBolt: MCP-native memory and SEO tools that run alongside Telegram in the same client.

Explore ContextBolt

The Telegram MCP server lets an agent send and read Telegram messages. Its most sensible use is as an output channel: giving an automated process somewhere to report that you will actually see, since most people check Telegram more reliably than email.

What it actually does

Using a bot token from BotFather, the server exposes Telegram’s messaging API. The agent can send messages to chats and channels the bot has access to, and read messages where the bot’s permissions and Telegram’s privacy settings allow. Group behaviour is deliberately restricted by Telegram; a bot in privacy mode sees messages directed at it rather than everything.

Practical patterns:

  • ‘Send the summary of that run to my alerts channel.’
  • ‘Post this week’s numbers to the team group every Monday.’
  • ‘Tell me if anyone mentions the release in the support channel.‘

Why use it

Agents that do work in the background need somewhere to report, and email is where notifications go to be ignored. A Telegram channel is checked, supports formatting, and works on a phone without an app switch. Wiring the end of an automated workflow into a chat you already read is a small change that makes the difference between an automation you trust and one you forget exists.

Gotchas

Use the Bot API, not user-account automation. Driving a personal account through unofficial clients is against Telegram’s terms and can get the account restricted, and it also means an agent has access to every private conversation you have. Bots are constrained deliberately and that constraint is a feature. Rate limits apply and a chatty agent will hit them. Keep the bot token treated as a secret; anyone holding it can post as your bot.

Built by ContextBolt

This directory is built by ContextBolt

We build MCP-native tools that give your AI the context it cannot reach on its own. Bookmarks turns your saved posts into agent-queryable memory. SEO puts live keyword and ranking data inside Claude. Both run alongside Telegram in the same client.

Explore the products →

Telegram MCP server: FAQs

Does it use a bot or my account?

Prefer the Bot API. Automating a personal Telegram account sits against Telegram's terms and risks the account, quite apart from the privacy implications.

Can it read a group chat?

A bot reads what it is permitted to read in groups it has been added to, subject to Telegram's privacy mode. It cannot silently read everything.

What is it useful for?

Notifications and alerts. Having an agent report into a channel you already watch is a low-effort way to close a loop.

Where does the token come from?

From BotFather, Telegram's own bot for creating bots. Treat the token as a credential.