English Français العربية

Telegram Bot MCP

Community Other

Covers the entire Telegram Bot API.

Source code Documentation

What can you do with Telegram Bot MCP?

  • Messages — send (text, photo, video, audio, document, location, poll, dice, sticker, media groups), edit, forward, copy, delete, pin/unpin, reactions
  • Chats — info, settings, permissions, invite links, member management, verification
  • Bot — commands, profile, settings, description, menu button, admin rights
  • Stickers — create/edit/delete sticker sets, upload stickers, custom emoji
  • Payments — invoices, star transactions, gifts, refunds
  • Forums — create/edit/close/reopen/delete topics
  • Stories — post, edit, delete, repost
  • Business — business messages, accounts, connections

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. telegram-bot-mcp
  2. Features
  3. Quick Start
  4. Environment Variables
  5. Project Structure
  6. License

telegram-bot-mcp

Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API — messages, chats, stickers, payments, forums, stories, and more.

Features

  • Messages — send (text, photo, video, audio, document, location, poll, dice, sticker, media groups), edit, forward, copy, delete, pin/unpin, reactions
  • Chats — info, settings, permissions, invite links, member management, verification
  • Bot — commands, profile, settings, description, menu button, admin rights
  • Stickers — create/edit/delete sticker sets, upload stickers, custom emoji
  • Payments — invoices, star transactions, gifts, refunds
  • Forums — create/edit/close/reopen/delete topics
  • Stories — post, edit, delete, repost
  • Business — business messages, accounts, connections
  • Games — send games, set scores, high scores
  • Webhooks — set, delete, get info

Quick Start

npm install
Claude Code
claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "telegram": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-telegram/index.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_token"
      }
    }
  }
}

Environment Variables

VariableRequiredDescription
TELEGRAM_BOT_TOKENYesBot token from @BotFather
TELEGRAM_DEFAULT_CHAT_IDNoDefault chat ID (skip chat_id in tool calls)
TELEGRAM_DEFAULT_THREAD_IDNoDefault topic/thread ID for forum supergroups

Project Structure

index.js              # Entry point — registers all tool modules
utils/api.js          # Telegram API client, rate limiting, retry logic
tools/
  messages/           # send, edit, forward, manage
  chat/               # info, settings, invite, members, verify
  bot/                # core, commands, profile, settings
  stickers.js
  payments.js
  forum.js
  stories.js
  business.js
  games.js
  webhook.js

License

MIT

Frequently asked questions

What is Telegram Bot MCP?

Covers the entire Telegram Bot API.

How do I install Telegram Bot MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Telegram Bot MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Telegram Bot MCP?

It is published by FantomaSkaRus1. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.