Advertise
MCP.so
Sign In

Telegram MCP Server

@NexusX-MCP

Repository

Basic information

Category

Communication

License

MIT license

Transports

stdio

Author

NexusX-MCP

About Telegram MCP Server

An MCP server implementation that provides tools for interacting with the [Telegram Bot API](

#telegram#bot-api#mcp-server

Telegram MCP Server config

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

{
  "mcpServers": {
    "telegram-mcp-server-nexusx-mcp": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "dist/index.js"
      ]
    }
  }
}

Telegram 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 MCP Server?

An MCP server that provides tools for interacting with the Telegram Bot API. It allows AI assistants to send messages, retrieve bot information, receive updates, and forward messages programmatically.

How to use Telegram MCP Server?

Set the TELEGRAM_BOT_TOKEN environment variable with your bot token from @BotFather. Install dependencies with npm install, build with npm run build, and run the server with npx @modelcontextprotocol/inspector node dist/index.js. Open http://127.0.0.1:6274 to configure and test the tools.

Key features of Telegram MCP Server

  • get_bot_info: Retrieves basic bot information (no parameters required)
  • send_message: Sends a message to a specified chat (requires chatId and text)
  • get_updates: Receives incoming updates using long polling (optional offset, limit, timeout, allowed_updates)
  • forward_message: Forwards messages between chats (requires chatId, fromChatId, messageId)
  • All tools accept optional parameters for additional Telegram API features

Use cases of Telegram MCP Server

  • AI assistant sending notifications or replies to a Telegram chat
  • Retrieving bot details (name, username, etc.) for verification or display
  • Polling for new messages, channel posts, callback queries, or other updates
  • Forwarding messages from one chat or channel to another
  • Integrating Telegram messaging into automated workflows without a full bot client

Frequently asked questions

1

How do I get a Telegram bot token?

Talk to [@BotFather](https://t.me/BotFather) on Telegram, create a new bot with the `/newbot` command, and copy the generated token. Keep it secure.

2

What environment variable is required?

You must set `TELEGRAM_BOT_TOKEN` to your bot token. The token is a string like `110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw`.

3

What runtime or dependencies are needed?

The server requires Node.js and npm. Run `npm install` to install dependencies, then build with `npm run build`.

4

Can I customize message formatting (parse_mode, reply_markup)?

Yes, the `send_message` tool accepts an optional `params` object that includes parameters like `parse_mode`, `reply_markup`, etc.

5

Is the server licensed for commercial use?

Yes, the server is licensed under the MIT License, which permits free use, modification, and distribution.

Comments

More Communication MCP servers

Paddock Cards

Paddock

Send birthday cards, Christmas cards and postcards, printed and mailed for you.

S

Summer

Summer

Telehealth support for Claude, Codex and Cursor. Investigate stuck orders and billing issues, review case evidence, connect your tools and prepare next steps with Summer.

Soprano Connect MCP Server

soprano-mcp

Soprano Connect MCP Server enables you to build AI agents that can communicate, engage customers, and manage communications workflows through the Soprano Connect platform using the Model Context Protocol (MCP).

B2B Creators

Social Tree Global

Agencies and GTM teams use HeyReach and Instantly to run LinkedIn outbound from personal sender profiles — but those profiles sit empty and prospects don't accept. B2B Creators is the content layer that keeps every sende

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

1
Advertise