Skip to main content
Glama
telegram-bot-mcp

telegram-bot-mcp

# Telegram Bot MCP Server

Cursor MCP server for Telegram Bot API (@The2TestGPTBot).

Tools

Tool

Description

tg_send_message

Send text to chat/topic (chat_id, text, optional parse_mode, message_thread_id, reply_to_message_id, disable_notification, business_connection_id)

tg_get_updates

Recent updates — discover chat_id / topic ids

tg_get_chat

Chat info by id or @username

tg_get_me

Bot identity

Related MCP server: telegram-mcp

Setup

npm install

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["C:\\path\\to\\telegram-bot-mcp\\index.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "<your bot token>"
      }
    }
  }
}

Keep the token only in mcp.json / env — never commit it.

After code changes: Cursor Settings → MCP → Reload telegram.

Notes

  • Forum groups: always pass message_thread_id, otherwise the message won't land in the topic.

  • Business: optional business_connection_id.

  • If fetch failed / timeout — check VPN / access to api.telegram.org:443.

Stack

  • @modelcontextprotocol/sdk

  • zod

  • Node.js (ESM)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      An MCP server that enables interaction with Telegram messaging platform, allowing users to retrieve unread messages, fetch entity information, and send messages through natural language interfaces.
      6
      10
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables interaction with Telegram to send, read, and search messages across chats and dialogs. It supports waiting for incoming messages and retrieving conversation history through natural language commands.
      47 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that exposes a Telegram bot, enabling sending messages and retrieving updates through natural language.
      3
      42 PyPI
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      An MCP server for interacting with Telegram bots and channels using the Telegraf library. It allows AI agents to send messages, manage channels, forward content, and intelligently respond to Telegram conversations.
      5
      52 npm
      8
      -