# MCP Telegram Bot

> MCP Telegram Bot is an open-source MCP server for communication. MCP server that lets AI clients send messages and read updates via a Telegram bot. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/daedalus/mcp-telegram-bot
- **MCP Registry name:** io.github.daedalus/mcp-telegram-bot
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README says the server wraps a Telegram bot so that MCP-compatible AI clients can call it as a set of tools. Setup starts with creating a bot through BotFather on Telegram, then supplying the bot token through the TELEGRAM_BOT_TOKEN environment variable before launching the server over stdio.

Once running, it exposes three tools: sending a message to a chat, returning the bot's own identity, and fetching recent updates received by the bot. It also offers a bot status resource. The project is published on PyPI and is MIT licensed.

It suits developers who want an assistant or agent to post into Telegram chats or check incoming bot traffic without writing their own integration.

## Features

- **Send chat messages:** Lets an AI client post a message into a Telegram chat through the bot.
- **Bot identity lookup:** Returns information about the bot account using the get_me tool.
- **Recent update retrieval:** Fetches recent updates the bot has received from Telegram.
- **Bot status resource:** Exposes a bot://status MCP resource describing the bot's state.
- **Stdio transport:** Runs as a local process over stdio and installs from PyPI with pip.

## Good for

- Let an AI assistant send notifications to a Telegram chat
- Check which messages a Telegram bot has recently received
- Confirm the bot's account details during agent setup

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-telegram-bot -- uvx mcp-telegram-bot
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-telegram-bot": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
```

## Tools

- `send_message`: Send a message to a Telegram chat
- `get_me`: Get bot information
- `get_updates`: Get recent updates from Telegram

## FAQ

### How is the server configured?

Set the TELEGRAM_BOT_TOKEN environment variable to a token obtained from @BotFather, then run mcp-telegram-bot.

### What license is it under?

The README lists the MIT license.

### Is MCP Telegram Bot free?

Yes. MCP Telegram Bot is open source, so you can use and self-host it for free.

### How do I add MCP Telegram Bot to Claude Code?

Run this command in your terminal: claude mcp add mcp-telegram-bot -- uvx mcp-telegram-bot

### What are the best alternatives to MCP Telegram Bot?

The closest alternatives to MCP Telegram Bot are Telegram MCP by usefulapi, Telegram MCP, MCP Zmq, Fast MCP Telegram and Telegram (tg-mcp).

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Telegram MCP by usefulapi](https://ai-powered.com/mcp/telegram-mcp-by-usefulapi): Telegram MCP by usefulapi is a freemium MCP server for communication.
- [Telegram MCP](https://ai-powered.com/mcp/telegram-mcp-5): Telegram MCP is an open-source MCP server for communication.
- [MCP Zmq](https://ai-powered.com/mcp/mcp-zmq): MCP Zmq is an open-source MCP server for communication.
- [Fast MCP Telegram](https://ai-powered.com/mcp/fast-mcp-telegram): Fast MCP Telegram is an open-source MCP server for communication.
- [Telegram (tg-mcp)](https://ai-powered.com/mcp/telegram-tg-mcp): Telegram (tg-mcp) is an open-source MCP server for communication.
- [Chatroost — unofficial Telegram MCP server](https://ai-powered.com/mcp/chatroost-unofficial-telegram-mcp-server): Chatroost — unofficial Telegram MCP server is an open-source MCP server for communication.
- [Secure Telegram](https://ai-powered.com/mcp/secure-telegram): Secure Telegram is an open-source MCP server for communication.
- [chatmux](https://ai-powered.com/mcp/chatmux): chatmux is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/mcp-telegram-bot
