Skip to content
MCP server

MCP Telegram Bot

MCP server that lets AI clients send messages and read updates via a Telegram bot

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About MCP Telegram Bot

MCP Telegram Bot is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add mcp-telegram-bot -- uvx mcp-telegram-bot

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-telegram-bot": {
      "command": "uvx",
      "args": [
        "mcp-telegram-bot"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free and open source under MIT.

More servers for the same service

MCP Telegram Bot 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.

How AIPoweredBot checks servers