Advertise
MCP.so
Sign In

Telegram Bot MCP Server

@siavashdelkhosh81

Repository

Basic information

Category

Communication

License

MIT

Transports

stdio

Author

siavashdelkhosh81

About Telegram Bot MCP Server

Telegram bot mcp server

#telegram-bot#mcp-server#api-integration

Telegram Bot MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Telegram Bot MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Telegram Bot MCP Server?

Telegram Bot MCP Server is a Model Context Protocol (MCP) server that integrates the Telegram Bot API into AI assistants. It provides tools for sending messages, managing users, and configuring bot settings, with intelligent message splitting and comprehensive error handling. It is designed for developers and AI assistant users who need to interact with Telegram through MCP.

How to use Telegram Bot MCP Server?

Run directly with npx telegram-bot-mcp-server after setting the TELEGRAM_BOT_API_TOKEN environment variable with a bot token from BotFather. Alternatively, install globally or locally via npm and configure your MCP client (e.g., Claude Desktop) with the server command and environment variable.

Key features of Telegram Bot MCP Server

  • Intelligent message splitting for Telegram’s 4096-character limit
  • Comprehensive error handling with detailed error codes
  • NPX support for zero-install execution
  • Easy integration with MCP clients
  • Rich API coverage for messaging, user management, and bot configuration
  • Cross-platform support (Windows, macOS, Linux)

Use cases of Telegram Bot MCP Server

  • Send long messages or photo captions that automatically split across messages
  • Manage chat members by banning or unbanning users
  • Retrieve chat and member information for monitoring
  • Update bot name, description, and command list remotely
  • Test bot authentication and retrieve bot details

Frequently asked questions

1

What are the prerequisites for using this server?

Node.js 18+ and a Telegram Bot Token obtained from @BotFather.

2

How do I get a Telegram bot token?

Open Telegram, start a chat with @BotFather, send `/newbot`, follow the prompts to name your bot, and copy the provided API token.

3

What happens if my message exceeds 4096 characters?

The server automatically splits the message into parts while preserving word boundaries and formatting, and sends them sequentially with part indicators.

4

What should I do if I get a “No bot token” error?

Set the `TELEGRAM_BOT_API_TOKEN` environment variable to your bot token before running the server, e.g., `export TELEGRAM_BOT_API_TOKEN="your_token_here"`.

5

How can I enable debug logging?

Set the environment variable `NODE_ENV=development` when running the server: `NODE_ENV=development npx telegram-bot-mcp-server`.

Comments

More Communication MCP servers

AdaptlyPost

Taras Shynkarenko

AdaptlyPost: Schedule and publish social posts to Instagram, TikTok, YouTube, X, Facebook, LinkedIn, Pinterest, Threads, and Bluesky from any MCP client.

Agent Inbox

Agent Inbox

Give your agent an inbox. Its own address on email, Slack and Telegram. A product of Novu

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

1

Atomic Mail Agentic

Atomic-Mail

Let your agents read, send and react to email autonomously, without human involvement

255

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

Advertise